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Bevor ich das Amiga-Assembler-Buch schrieb, habe ich acht verschiedene 
Assembler getestet und davon drei, nämlich Metacomco, SEKA und Devpac, in die 
engere Wahl gezogen. 

Nach einem ausführlichen Test dieser drei stand für mich als eindeutiger Sieger 
Devpac von HiSoft fest. Ich habe daraufhin die zahlreichen Listings des Buches mit 
Devpac entwickelt und immer gehofft, daß auch die Leser meiner Meinung sein 
werden. 

Deshalb freut es mich besonders, daß sich ein so führender Software-Spezialist wie 
Markt&Technik dafür entschieden hat, dieses Produkt in sein Angebot aufzu¬ 
nehmen, womit meine Einschätzung dieses Assemblers bestätigt wurde. 

Das war für mich auch der Grund, die Übersetzung des Handbuches zu übernehmen, 
obwohl ich sonst viel lieber kreativ als Programmierer und Autor arbeite. 

Ganz konnte ich diese »Kreativität« auch bei der Übersetzung nicht unterdrücken, 
weshalb dies keine Wort-für-Wort-Übersetzung geworden ist. Ich habe einige 
Inkonsistenzen beseitigt und einige Passagen, die meiner Meinung nach Einsteiger 
nicht auf Anhieb verstehen, etwas klarer ausgedrückt, als es das Original tut. Ande¬ 
rerseits bin ich schon der Ansicht, daß im Original einige Passagen sehr ausführlich 
beschrieben sind, hier habe ich dennoch nichts gekürzt und nichts weggelassen. 

Einige Wörter habe ich nicht übersetzt. Dabei handelt es sich um Fachausdrücke 
aus der Assembler-Programmierung und um Begriffe aus der Amiga-Welt. Die 
Assembler-Sprache selbst ist nun einmal englischer Klartext, da würde ein Ein¬ 
deutschen nur die Verbindung zur Praxis aufheben. Sinngemäßes gilt für die Amiga- 
Welt. Die vielen hundert Funktionen, die Ihnen das Betriebssystem zur Verfügung 
stellt, haben englische Namen. Das gilt auch für alle CLI-Kommandos. Hier würde 
zum Beispiel das Wort »Inhaltsverzeichnis« anstatt »Directory« die Verbindung zu 
Kommandos wie »dir« oder »makedir« aufheben. 
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Eines fehlt im Buch ganz, nämlich die Erläuterung sehr häufig gebrauchter Namen. 
»Devpac« ist das Kürzel für »Development Package« also Entwicklungspaket. 
Tatsächlich erhalten Sie mit Devpac ein Paket bestehend aus Editor, Assembler und 
Debugger (und einigen Zugaben). 

MonAm oder MonAmiga ist das Kürzel für Monitor Amiga. Hierbei handelt es sich 
um einen symbolischen Debugger. Ich nenne MonAm auch Mon Ami (mein 
Freund), weil er mir schon aus so mancher Klemme geholfen hat. 

Bliebe noch GenAm oder GenAmiga. Gen heißt Generator, genau Programm- 
Generator, womit die Kombination von Editor und Makro-Assembler gemeint ist. 
Da diese beiden wichtigsten Werkzeuge als integrierte Einheit ständig im RAM 
stehen, reicht ein Tastendruck im Editor, um den Assembler aufzurufen. Dieser 
merkt sich bis zu 30 Fehlerstellen, womit man dann im Editor von Fehlerzeile zu 
Fehlerzeile gehen und verbessern kann. Was dann jeweils falsch ist, steht sogar in 
der Statuszeile. 

Dieser Bedienkomfort verbunden mit hohem Tempo und allen Leistungsmerkmalen 
guter Assembler hat mich für Devpac begeistert und tut es immer noch. 

Ich wünsche Ihnen viel Erfolg bei der Entwicklung Ihrer Programme. Die besten 
Voraussetzungen dafür haben Sie mit Ihrer Entscheidung für Devpac bereits 
geschaffen. 

Happy Programming 
Ihr 

Peter Wollschlaeger 




Kapitel 


1 


Einführung 


1.1 Was ist Devpac Amiga? 

Devpac Amiga ist ein superschnelles Assembler-Entwicklungspaket für alle 
Commodore-Computer. Es enthält alle Programme, die Sie zur Entwicklung von 
Programmen in Maschinensprache benötigen. Darin enthalten sind ein Makro- 
Assembler, ein Bildschirm-Editor, ein Linker und Include-Dateien, mit denen Sie 
eine Verbindung mit dem Betriebssystem des Amiga hersteilen können. 


1.2 Copyright 

Die Software von Devpac wird auf einer nicht kopiergeschützten Diskette aus¬ 
geliefert. Software und Handbuch unterliegen dem deutschen Urheberrecht. Jegliche 
Vervielfältigung, auch auszugsweise, ist nur nach schriftlicher Genehmigung des 
Verlages gestattet. Hiervon ausgenommen ist lediglich das Anfertigen von 
Sicherungsdisketten ausschließlich für den eigenen Bedarf. Die Weitergabe an 
Dritte ist nicht zulässig. 


1.3 Anfertigen einer Sicherungskopie 

Bevor Sie Devpac einsetzen, sollten Sie von der mitgelieferten Diskette eine Kopie 
erstellen und das Original an einem sicheren Platz verwahren. Es ist nicht kopier¬ 
geschützt, um Ihnen ein einfaches Arbeiten zu ermöglichen. Bevor Sie mit dem 
Kopieren beginnen, aktivieren Sie den Schreibschutz Ihrer Originaldiskette, um ihre 
versehentliche Zerstörung zu vermeiden. Die genaue Kopiermethode hängt davon 
ab, wie viele Laufwerke Sie besitzen. Aber alle Methoden machen es erforderlich, 
daß Sie im CLI sind und mit dem ins interne Laufwerk eingelegten schreib¬ 
geschützten Original beginnen. 





12 Kapitell 


1.4 Die Readme-Datei 

Wie alle HiSoft-Produkte wird auch Devpac laufend verbessert, und die neuesten 
Informationen, die noch nicht in das Handbuch aufgenommen werden konnten, 
werden dann in der Readme-Datei bekanntgegeben. Wenn Sie noch nicht im CLI 
sind, sollten Sie warten, bis alle Diskettenaktivitäten aufhören. Nehmen Sie dann 
alle Disketten heraus, und drücken Sie die Control- und beide Amiga-Tasten gleich¬ 
zeitig. Legen Sie jetzt die Devpac-Amiga-Diskette ein. Sobald Sie sich im CLI 
befinden, geben Sie 

type readme (Return I 

ein. Das (durchlaufende) Display kann durch Drücken der rechten Maustaste 
angehalten werden. Nachdem die Taste losgelassen wurde, läuft der Text weiter ab. 


1.5 Einführung in das CU 

Wie die meisten Entwicklungstools ist auch Devpac für den Betrieb im CLI 
(Command Line Interface) ausgelegt. Wenn Sie die Diskette von der Workbench 
aus inspizieren, werden Sie deshalb nicht sehr viele Icons sehen (genauer gesagt, 
keine von Devpac-Files). Das CLI ist für den Normalanwender versteckt, aber als 
Programmierer brauchen Sie es. Die mitgelieferte Diskette 1 ist eine modifizierte 
Workbench-Diskette. Wenn Sie nach dem Einschalten (beim Amiga 1000 nach dem 
Durchlauf der Kickstart-Diskette) nach der Workbench-Diskette gefragt werden, 
legen Sie die Devpac-Diskette ein. 

Wenn Ihr Amiga schon mit einer anderen Workbench-Diskette gestartet wurde, 
warten Sie eventuelle Disk-Aktivitäten ab, legen dann die Devpac-Diskette ein und 
machen einen Reset, was durch gleichzeitiges Drücken der [ Ctrl ] -Taste und der 
beiden Amiga-Tasten erreicht wird. Das CLI entspricht der Benutzeroberfläche 
anderer nicht grafisch orientierter Computer, wie zum Beispiel MS-DOS oder 
CP/M. Es verlangt die Eingabe von Kommandos wie 

dir I Return I 

um eine Directory-Anzeige zu erhalten. Eine Beschreibung darüber, wie das CLI 
benutzt wird, finden Sie in Anhang D. 
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1.6 Details zum Anfertigen einer Sicherungskopie 

Bevor Sie Sicherungskopien erstellen, sollten Sie sich vergewissern, daß Ihre 
Master-Disketten schreibgeschützt sind. 

1.6.1 Amiga mit einem Diskettenlaufwerk 

Geben Sie nach dem Booten mit der Devpac-Amiga-Diskette 
diskcopy dfO: to dfO: I Return I 

ein. Dann folgen Sie den Anweisungen, die auf dem Bildschirm erscheinen. Die 
»disk to copy from« ist unsere Master-Diskette, die »disk to copy to« sollte eine 
neue, leere Diskette sein. Wenn die Kopie fertig ist, legen Sie die Devpac-Amiga- 
Disk 2 ein und geben 

diskcopy dfO: to dfO: [Return I 

ein. Befolgen Sie dann die Anweisungen auf dem Bildschirm. Die zu kopierende 
Diskette ist die Master-Diskette 2, die Diskette, auf die kopiert wird, sollte eine leere 
Diskette sein. 

1.6.2 Amiga mit zwei Diskettenlaufwerken 

Geben Sie 

diskcopy dfO: to dfl: 1 Return 1 

ein. Legen Sie dazu die neue, leere Diskette in das externe Laufwerk. Drücken Sie 
dann I Return I . so daß eine Kopie von Diskette 1 gemacht wird. Wenn die Kopie 
angefertigt ist, legen Sie die Master-Disk 2 und eine leere Diskette in das externe 
Laufwerk ein. Folgen Sie dann den Anweisungen auf dem Bildschirm. Nun haben 
Sie eine Sicherungskopie. Warten Sie ab, bis alle Diskettenaktivitäten beendet sind, 
nehmen Sie die Diskette(n) heraus, und verwahren Sie das Original an einem 
sicheren Ort. Legen Sie nun die neue Kopie ein, und erzeugen Sie einen Reset. 
( 1 Ctrl I und beide Amiga-Tasten gleichzeitig drücken.) 


1.7 Einrichten einer Arbeitsdiskette 

Obwohl wir eine Sicherungskopie haben (die haben Sie doch erstellt, oder?), hat 
diese nicht genügend Kapazität zum effektiven Programmieren. Deshalb sollte eine 
Arbeitsdiskette angelegt werden. Die genaue Vorgehensweise hängt von Ihrer 
Hardware-Konfiguration ab. 
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1.7.1 Systeme mit einem Laufwerk 

Bei Systemen mit nur einem Laufwerk ist es das beste, möglichst viel von der 
Workbench-Disk zu löschen. Dafür kommen zunächst alle .INFO-Files (welche für 
die Icon-Darstellung gebraucht werden), Fonts und Druckertreiber in Frage. Die 
folgenden Kommandos sind (auf einer weiteren Sicherungskopie) dafür erforderlich: 

cd dfO: I Return ] 
delete #?.info lReturnI 
delete devs/printers I Return I 
delete dir [ReturnI 

Jetzt wird eine Liste von Druckertreibem ausgegeben. Löschen Sie mit dem Delete- 
Kommando diejenigen, die Sie nicht brauchen. Wenn trotzdem noch zu wenig Platz 
vorhanden ist, löschen Sie am besten das EXAMPLES-Verzeichnis, selten 
gebrauchte Include-Dateien und einige Kommandos des C:-Verzeichnisses. 

1.7.2 Systeme mit zwei Laufwerken 

Besitzer von Systemen mit zwei Laufwerken sollten die Workbench freihalten von 
Source-Code und diese Dateien mit den Include-Dateien auf Diskette im externen 
Laufwerk speichern. Die Kommandos dafür sind: 

format drive dfl: name "Source" I Return] 

Wichtig: Der erste Befehl formatiert eine neue Diskette im externen Laufwerk und 
vernichtet damit alle darauf befindlichen Daten. Wenn Sie eine vorformatierte 
Diskette benutzen, brauchen Sie diesen Befehl nicht auszuführen. 

Legen Sie eine neue Diskette in das externe Laufwerk, und geben Sie dann I Return I 
ein, um sie zu formatieren. Nun folgt: 

cd dfO: [Return 1 

makedir dflrinclude [Return 1 

makedir dflrexamples I Return I 

copy include to dflrinclude all [ReturnI 

copy examples to dfliexamples all [Return 1 

delete include all 1 ReturnI 

delete examples all IReturn 1 

Die Kommandos schaffen Directories auf dem externen Drive für die Beispiel¬ 
programme (in EXAMPLES) und die Include-Files. Dann löschen Sie diese von 
Ihrer Arbeitskopie im internen Laufwerk. 
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Sie wollen nun bestimmt die Programm-Dateien von der Devpac-Amiga-Diskette 2 
auf Ihre Workbench kopieren. Legen Sie deshalb die Sicherungskopie der Devpac- 
Amiga-Master-Diskette 2 in df 1: und geben Sie 

copy dfl:c to dfO:c all I Return I 

ein. Nach 

cd dfl: I Return I 

wird auf das externe Laufwerk umgeschaltet, so daß Sie Ihre Quellfiles einfacher 
(ohne Angabe des Pfadnamens) editieren können. Es ist oft nützlich, ein solches 
Kommando in das Startup-File einzubauen. 

1.7.3 Für Systeme mit Festplatte 

Festplattenbesitzer sollten zuerst von der Harddisk booten und nicht von der 
Devpac-Diskette. Danach sollte die Devpac-Diskette 1 in das interne Laufwerk 
eingelegt und die folgenden Befehle ausgeführt werden, um die Programme auf die 
Harddisk zu kopieren: 

copy df0;c/genam2 to c: (Return I 
copy df0:c/monam2 to c: I Return ] 
copy df0:c/genim2 to c: (Return I 

Als nächstes sollten die beiden Subdirectories kopiert werden, doch das hängt von 
Ihren Anforderungen ab. Sie könnten sich zum Beispiel ein gesondertes Devpac- 
Directory anlegen. Was immer Sie auch wählen - Sie müssen die Include- und 
Example-Directories komplett kopieren. Wenn Sie sich für ein gesondertes Devpac- 
Directory entschieden haben, sind folgende Kommandos erforderlich (angenommen, 
Ihre Harddisk heißt dhO:) 

makedir dhOidevpac IReturn] 

copy dfO:include to dhOidevpac all IReturn 1 

copy dfO:examples to to dhO:devpac all I Return I 

Beachten Sie, daß Sie die INCDIR-Direktive entsprechend ändern müssen, wenn Sie 
das Include-Directory in ein anderes Directory gepackt haben. Sie können auch die 
folgende Datei von Ihrer Devpac-Amiga-Diskette 2 kopieren: 

copy dfO:c/blink to dhOic 

Andere Dateien brauchen Sie erst dann kopieren, wenn sie benötigt werden. 





16 Kapitel 1 


1.8 Der Entwicklungs-Zyklus 

Das Devpac-Entwicklungspaket dient zur Eingabe des Assembler-Quelltextes, zur 
Assemblierung in Maschinen-Code und zum Debuggen, wenn ein Programm nicht 
(oder nicht so wie geplant) laufen sollte. Abhängig von der jeweiligen Anwendung 
können Sie auch einen Linker benutzen, um zum Beispiel mehrere Module zusam¬ 
menzubinden. Auch Module, die von Compilern höherer Programmiersprachen 
generiert wurden, können so mit Assembler-Modulen gebunden werden. Der 
normale Entwicklungszyklus kann am besten mit einem Diagramm wie dem 
folgenden dargestellt werden. Devpac wurde entwickelt, um diesen Ablauf so 
schnell und effektiv wie möglich bewältigen zu können. 



Die Linkfunktion ist optional, der Assembler kann auch sofort ausführbaren Code 
generieren. Natürlich wird ein Compiler (wie im Bild angedeutet) nicht mitgeliefert, 
es können aber alle gängigen verwendet werden. 


1.9 Inhalt der Diskette 

Die erste der zwei beigefügten 3,5"-Disketten ist eine Standard-Workbench- 
Diskette, die so konfiguriert ist, daß der Amiga nach dem Einschalten (oder einem 
Reset) im CLI ist. Die zweite Diskette enthält zusätzliche Dateien. 
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1.9.1 Diskettel 


Programme (im Unterverzeichnis C/): 


GenAm2 

MonAm2 

Genlm2 


der Bildschirmeditor und das Kontrollprogramm 
der Disassembler/Debugger 
der Assembler 


Sonstige Dateien 

libs/libfile.monam vom Debugger verwendete Binärdatei 
libs/arp.library Zusatz-Library 

Readme letzte Informationen zu Devpac Amiga 


Zusätzliche Unterverzeichnisse 

include beinhaltet Dateien für den Zugriff auf das Betriebssystem, 

Beschreibung in Anhang C.2 

examples der Source-Code zu verschiedenen Beispielprogrammen, 

Beschreibung in Anhang C.3 


1.9.2 Diskette 2 


Programme (im Unterverzeichnis C/) 

BLink Public-domain-Linker (siehe Kapitel 3.12) 

ConvertFD Utilitiy zum Konvertieren von FD-Dateien 

Convertl Utility zum Konvertieren von Include-Dateien 

einige Workbench-Dateien, die auf Disk 1 nicht genügend Platz haben 

Textdateien 

blink.doc Anweisungen zum Gebrauch des Linkers 


Zusätzliche Unterverzeichnisse 


include.cbm 
include.Strip 

fd.files 

library 

arp 


die Original-Commodore-Include-Dateien mit Kommentierung 
die Original-Commodore-Include-Dateien ohne Kommen¬ 
tierung 

die Original-Commodore-fd-Dateien beinhaltet, welche Regi¬ 
ster beim Aufruf von Libraries gebraucht werden 
beinhaltet amiga.lib 

beinhaltet Teile von Charlie Heaths AmigaDOS-Replacement- 
Projekt (ARP) 
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1.10 Zum Gebrauch dieses Handbuchs 

Dieses Handbuch macht keinen Versuch, die 68000-Programmierung zu lehren oder 
auf Einzelheiten des 68000-Befehlssatzes einzugehen. Auf geeignete Literatur wird 
im Anhang verwiesen. Die Anhänge geben einen Überblick über die technischen 
Zusammenhänge des Amiga, sie sind aber nicht als komplette technische 
Beschreibung der Maschine gedacht. Dieses Handbuch besteht aus vier Teilen: der 
Einführung, einem Kapitel über den Editor/Assembler, einem Kapitel über den 
Makro-Assembler und einem Kapitel über den Debugger. Zusätzlich gibt es noch 
sechs Anhänge, die verschiedene Informationen beinhalten. Ihr Gebrauch des 
Handbuchs hängt davon ab, welcher Benutzertyp Sie sind. 

1.10.1 Benutzer von Devpac Amiga, Version 1 

Gehen Sie in Anhang F und lesen Sie das Kapitel, in dem die neuen Features 
beschrieben werden. Wenn Sie MonAm benutzen wollen, sollten Sie Kapitel 4 
durcharbeiten, denn MonAm wurde beträchtlichen Veränderungen unterworfen. 
Danach werden Sie vermutlich das Handbuch auf Neuerungen durchsehen. 


1.10.2 Anfänger 

Am Ende dieses Kapitels finden Sie eine einfache Einführung, die Sie nach¬ 
vollziehen sollten, um mit den Hauptteilen des Programms vertraut zu werden. In 
Kapitel 2 wird der Editor behandelt, in Kapitel 3 wird der Assembler vorgestellt. 
Dessen Funktionen werden Ihnen klarer, wenn Sie einmal ein erfahrener Devpac- 
Anwender sind. Besonders ans Herz legen wollen wir Ihnen die Übersicht über den 
Debugger in Kapitel 4. Ein Blick auf den mitgelieferten Source-Code könnte 
hilfreich sein. 

1.10.3 Erfahrene Benutzer 

Wenn Sie bereits Erfahrungen in der 68000-Assemblierung sammeln konnten, aber 
noch nicht mit Devpac Amiga in Berührung gekommen sind, geben wir Ihnen hier 
einen kurzen Überblick, wie eine Quellcode-Datei assembliert wird: 

Laden Sie GENAM2.PRG, drücken Sie CÄ]-(T] und suchen Sie die Datei aus, die Sie 
in den Editor laden wollen. Drücken Sie E-® und wählen Sie die entsprechenden 
Optionen aus - wenn Sie ausführbaren Code erzeugen wollen, klicken Sie auf den 
Spe/c/ierknopf, um eine höhere Geschwindigkeit zu erzielen. ( Return I startet den 
Assembler, das Drücken einer beliebigen Taste hält ihn an, durch [ Return I kehren Sie 
in den Assembliervorgang zurück. Assemblierfehler werden gespeichert. Wenn Sie 
in den Editor zurückkehren, steht der Cursor auf dem ersten Fehler. Durch Eingabe 
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von [Ä]-[j] finden Sie auch weitere Fehler. Um das erfolgreich assemblierte 
Programm ablaufen zu lassen (vorausgesetzt, Sie haben in den Speicher 
assembliert), geben Sie (T|-(T| ein. Wenn Sie auf Diskette assembliert haben, 
verlassen Sie den Editor und lassen es vom CLI aus ablaufen. Als Schnelleinführung 
zum Debugger empfehlen wir Ihnen das folgende Kapitel. 


1.11 Eine Kurzeinführung 

Das folgende Kapitel ist eine kurze Einführung mit dem Ziel, Ihnen zu zeigen, wie 
einfach und schnell das Editieren, Assemblieren und Debuggen mit Devpac ist. In 
diesem Tutorial werden wir ein einfaches Programm assemblieren und debuggen. 
Das Programm selbst soll nur eine kurze Meldung auf dem Bildschirm ausgeben. 
Um diesem Tutorial folgen zu können, müssen Sie bereits im CLI sein. Wenn dies 
nicht der Fall sein sollte, so warten Sie alle Diskettenaktivitäten ab und nehmen alle 
Disketten heraus. Drücken Sie die ( Ctrl ] und beide Amiga-Tasten gleichzeitig, und 
legen Sie dann Ihre laut Abschnitt 1.6 erstellte Kopie ein. Um die Arbeit zu 
erleichtern, wird das Directory, in dem sich der Quelltext befindet, zum aktuellen 
Directory gemacht. Tippen Sie dazu 

cd examples I Return I 

ein. Als nächstes laden Sie den Editor/Assembler durch die Eingabe von 
genam2 I Return I 

Nach kurzer Zeit erscheint ein leeres Fenster. Um nun ein File zu laden, drücken Sie 
die rechte Maustaste, bewegen dann den Mauszeiger auf das Datei-Menü und 
wählen dort Laden ... aus. Es erscheint ein File-Requester. Klicken Sie das Namen¬ 
feld an und geben Sie den zu ladenden File-Namen ein, hier 

demo.s I Return I 

In dieser Kurzeinführung werden wir ein einfaches Programm mit zwei Fehlern 
assemblieren und debuggen. Das Programm selbst soll lediglich eine Meldung 
ausgeben. Wenn das File geladen ist, zeigt das Fenster die ersten Programmzeilen. 
Wenn Sie einen schnellen Blick auf das ganze Programm werfen wollen, können Sie 
die Tastenkombination I Shift I und U] oder I Ctrl l -fcl drücken, um eine Seite weiter¬ 
zublättern. 

Bei den meisten kurzen Programmen ist es am besten, wenn man sie versuchsweise 
assembliert, ohne gleich List-Files und Object-Files zu erzeugen. Damit ist eine 
schnelle Kontrolle auf Syntaxfehler, Tippfehler und ähnliches möglich. 
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Bewegen Sie den Mauszeiger auf das Programm-Mtnü, und wählen Sie 
Assemhlieren aus. Eine Dialogbox erscheint, in der nichts verändert werden braucht, 
außer daß der Knopf Nein angeklickt werden sollte. Klicken Sie dann auf 
Assemhlieren, oder geben Sie I Return ] ein, worauf der Assembliervorgang beginnt. 

Der Assembler zeigt den Fehler »Unbekannte Anweisung« an. Durch Drücken einer 
beliebigen Taste kehren Sie in den Editor zurück. Der Cursor steht darauf in der 
fehlerhaften Zeile, die Fehlermeldung wird in der Statuszeile angezeigt. Die Pro¬ 
grammzeile »MOV.L« sollte in »MOVE.L« geändert werden. Nachdem Sie das 
getan haben, klicken Sie wieder auf Assemhlieren im Programm-Menü. Wählen Sie 
diesmal Speicher, das Programm wird dann anstatt auf Diskette in den Speicher 
assembliert. Dadurch wird die Geschwindigkeit des Assemblers erhöht, und Probe¬ 
durchläufe können sofort ausgeführt werden. Erneutes Klicken auf Assemhlieren 
läßt den Assemblier-Vorgang weiterlaufen. Nach dem Drücken einer Taste kehren 
Sie in den Editor zurück und könnten das Programm nun ablaufen lassen. Zwar 
wurde diesmal ordnungsgemäß assembliert, jedoch ist das Programm noch nicht 
lauffähig. Sie würden vermutlich die Meldung »Software error task held« vom 
System erhalten. Darauf müßten Sie neu booten. Um Programme zu prüfen und 
Fehler zu finden, brauchen Sie den Debugger. Klicken Sie also auf Debuggen im 
Programm-Menü. Jetzt wollen wir den Debugger lediglich dazu einsetzen, um 
herauszufinden, ob Fehler vorhanden sind, und um deren Ursache zu ergründen. 
Drücken Sie also I Ctrl l -fRl. Nach einer kurzen Verzögerung erscheint am unteren 
Rand des Bildschirms die Meldung »Adreßfehler«, das Disassemblierungsfenster 
zeigt die Anweisung 

Start MOVE.L dosname.al 

Dadurch wird ein Adreßfehler erzeugt, denn »dosname« befindet sich in einer 
Adresse, auf die mit der »MOVE.L«-Anweisung nicht zugegriffen werden kann. 
Vor »dosname« sollte nämlich »#« stehen, damit die Adresse von »dosname« ins 
Register »al« geschrieben werden kann. Geben Sie zuerst I Ctrl l - fol ein, um in den 
Editor zurückzukehren, und danach [ Ctrl l -fcl. um das Debuggen zu beenden. Den 
Fehler können wir im Source-Code beseitigen. Geben Sie S-O ein, um an den 
Dateianfang zu gelangen, und klicken Sie auf Suchen im Suchen-Menü. Um die 
fehlerhafte Anweisung zu finden, geben Sie 

move.l 

ein und drücken dann I Return I . um die Suche zu starten. Gleich das erste Vor¬ 
kommen ist dasjenige, nach dem wir suchen: 


Start move.l dosname,al 
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Wir ändern dieses jetzt in 
Start move.l # dosname, al 

und assemblieren wieder. Wenn Sie dann auf Ausführen im Programm-Menü 
klicken, sehen Sie die angekündigte Meldung. Durch Drücken einer beliebigen 
Taste kehren Sie in den Editor zurück. Obwohl das Programm Jetzt läuft, benutzen 
wir MonAm, den Debugger, um das Programm Schritt für Schritt zu durchlaufen. 
Klicken Sie dazu auf Debuggen im Progf'amm-Menü, daraufhin erscheint der 
Debugger mit der Meldung »Breakpoint« und zeigt Ihr Programm. Das obere 
Fenster zeigt die Maschinenregister an, das zweite die Disassemblierung des Pro¬ 
gramms und das dritte weitere Speicher, ln Fenster 2, dem Disassemblierungs¬ 
fenster, sehen Sie die aktuelle Anweisung, in unserem Fall 

Start move.l # dosname, al 

Da im Source-Code die Debug-Option spezifiziert wurde, erscheinen die Symbole 
im Debugger. Sehen wir uns nun die Umgebung von »dosname« an. Geben Sie 
»A3« an, erscheint die Überschrift von Fenster 3 invertiert. Danach tippen Sie [ 3 * 
[XI . In die erscheinende Dialogbox mit der Frage »Window Start address?« geben 
Sie 

String 

(in Kleinbuchstaben) ein und ( Return I . Dadurch erscheint an dieser Adresse Fenster 
3, die Meldung wird in Hex und ASCII angezeigt. Um die Move-Anweisung auszu¬ 
führen, geben Sie I Ctrl | -|T| ein. Sie wird daraufhin ausgeführt, am Bildschirm 
erscheinen die neuen Werte des Programmzählers und des Registers Al. Nach 
abemialiger Eingabe von I Ctrl | - (T1 wird die MOVEQ-Anweisung ausgeführt und dO 
wird modifiziert. Die beiden folgenden Anweisungen betreffen die Expansion des 
CALLEXEC-Open-Library-Makro-Aufrufs. Mit I Ctrl | -[Y] single-steppen Sie die 
»move to a6«-Anweisung. Als nächstes erscheint 

JSR _LV00penLibrary(A6) 

Das ist der Aufruf der Exec-Library. Alle Aufrufe des Amiga-Betriebssystems 
haben die gleiche Form. Hier brauchen wir nicht single-steppen, da wir wissen, daß 
Amiga-DOS funktioniert (zumindest meistens!). Um den Systemaufruf als eine 
Anweisung zu behandeln, benutzen Sie [ Ctrl | -|T]. Single-steppen Sie nun TST.L 
DO. DO sollte ungleich 0 sein; das Z-Flag ist deshalb nicht in der Registeranzeige 
von MonAm enthalten. Fahren Sie nun fort, 1 Ctrl | -[T] einzugeben, bis Sie zu 

JSR _LV00utput(a6) 
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gelangen. Durch diesen Aufruf wird in der DOS-Library der Output-Handle gesucht. 
Mit ICtrll -fYI können Sie darüber hinweggehen. Single-steppen Sie weiter mit 
I Ctrl l -in. bis Sie zu 

JSR _LV0Write(a6) 

kommen. Durch diesen Aufruf wird unser String auf den Bildschirm geschrieben - 
wir sollten uns davon überzeugen, daß die Register korrekt gesetzt wurden, dl sollte 
den Output-Handle haben, der vom Output-Aufruf in dO rückgemeldet wurde. d2 
sollte die Adresse der Meldung beinhalten. In der Registeranzeige sehen Sie die 
ASCII-Bytes des Strings. Mit I Ctrl I -FtI übergehen Sie den Schreibaufruf. Um 
sicherzustellen, daß alles ordnungsgemäß arbeitet, geben Sie »V« ein. Der 
Programm-Bildschirm wird daraufhin angezeigt. Durch Eingabe einer beliebigen 
Taste kehren S ie in MonAm z urück . Das, was noch übrig ist, ist unsere Deinitia- 
lisierung. Mit [ Ctrl l -fTI und I Ctrl l -IYI können Sie sie durchlaufen. Die letzte 
Anweisung im Programm ist »RTS«. MonAm wird beendet, wenn RTS single¬ 
gesteppt wurde. Daraufhin kehrt man in den Editor zurück. 





2.1 Einführung 

Für die Eingabe und das Assemblieren eines Programms brauchen Sie einen Editor 
und einen Assembler. GenAm ist der Editor, der den Assembler lädt und zum 
Laufen bringt, Genim verleiht ihm das Erscheinungsbild eines Voll-Screen>Editors 
und eines Hochgeschwindigkeits-Assemblers in einem. Mit GenAm können Sie Ihre 
Programme auch direkt vom Speicher aus assemblieren, ohne das Programm ver¬ 
lassen zu müssen oder einen Diskettenzugriff zu machen und den Debugger per 
Tastendruck aufrufen zu müssen. Durch die Integration dieser Eigenschaften ist es 
möglich, Fehlerkorrekturen und Änderungen extrem schnell - da ja kein Disketten¬ 
zugriff erfolgt - zu vollziehen. 

In diesem Kapitel wird erläutert, wie der Editor gebraucht wird und wie Programme 
assembliert werden. Der Assembler und Editor an sich werden in den nächsten 
Kapiteln behandelt. Um GenAm laufen zu lassen, geben Sie vom CLI aus GENAM2 
ein. Wenn er geladen ist, wird ein Fenster geöffnet, in das Sie Einträge machen 
können. Sie können wahlweise eine Kommandozeile mit angeben, die den File- 
Namen eines zu editierenden Programms und verschiedene Optionen enthalten 
kann. 


Option 

Beispiel 

-s Setze Arbeitsbereich für Editor 

-slOO (ergibt 100 Kbyte) 

-X Setze Maximum XREFs 

-x250 (250 XREF erlaubt) 

+c Groß-/Kleinbuchstaben-Unterscheidung 


-c Kleinbuchstaben 


+1 Erzeugt linkbaren Code 


-1 Erzeugt ausführbaren Code 
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Die Bedeutung der Optionen wird Ihnen klarer, wenn Sie den Rest dieses Kapitels 
gelesen haben. Zum Beispiel startet das Kommando »genam2 examples/demo.s 
-s50 +c -1« GenAm, lädt das File demo.s in einen Arbeitspuffer von 50 Kbyte, beim 
Assemblieren wird Groß-/Kleinschrift unterschieden und ausführbarer Code erzeugt. 

Die Beschreibung des Editors und des Assemblers erfolgt in zwei getrennten 
Abschnitten. Beginnen wir mit dem Editor. 


2.2 Der Bildschirm-Editor 

2.2.1 Einführung 

Ein Text-Editor ist ein Programm, das Ihnen erlaubt, Textzeilen in den Speicher ein¬ 
zugeben, zu ändern, sie auf der Diskette zu speichern und von dort wieder zu laden. 
Es gibt zwei Arten von Editoren: zum einen Zeilen-Editoren, die jede Zeile einzeln 
behandeln und sehr schwierig zu bedienen sind, und zum anderen Bildschirm-Edi¬ 
toren, die Ihren Text auf einmal auf dem Schirm abbilden. Diese sind wesentlich 
einfacher zu bedienen. 

Der Editor-Teil von GenAm ist ein Bildschirm-Editor, der Ihnen die Eingabe von 
Text, das Ändern, Speichern und Laden von der Diskette erlaubt. Er läßt Sie auch 
den ganzen Text oder Teile davon ausdrucken und kann Begriffe finden und durch 
andere ersetzen. Er basiert auf Intuition, was heißt, daß er die sehr bedienerfreund¬ 
lichen Features des Amiga, die Ihnen von anderen Programmen her schon vertraut 
sind, bietet. Dazu gehören Fenster, Menüs und Mausbedienung. Wenn Sie jedoch 
die alten Methoden der Computer vor dem Fortschritt des WIMP gewohnt sind, so 
können Sie GenAm auch bedienen, ohne die Maus anfassen zu müssen. 

Der Editor ist RAM-orientiert, was bedeutet, daß das ganze File immer im RAM 
steht und Sie nicht warten müssen, bis der Editor jeweils Textsegmente von der 
bzw. zur Disk umspeichert. Weil der Amiga so viel Speicherplatz besitzt, gibt es 
hier ein Speicherlimit, wie man es oft bei älteren Editoren findet, nicht. Wenn Sie 
genug RAM haben, können Sie Files von über 300 Kbyte editieren (stellen Sie aber 
sicher, daß dann auf der Diskette noch genug Platz zum Abspeichem ist). Weil auch 
alle Editor-Aktionen wie die Suchfunktion RAM-orientiert sind, laufen sie blitz¬ 
schnell ab. Ein eingetipptes Programm bringt nicht viel, wenn Sie es nicht auf der 
Disk sichern können. Deshalb hat der Editor sehr vielfältige Optionen zum Laden 
und Speichern von Texten, was Ihnen erlaubt, Teile des Textes (oder den ganzen 
Text) zu sichern oder Textteile in die Mitte eines bestehenden Textes einzuladen, 
um nur einige Beispiele zu nennen. 
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Für die Bedienung des Editors stehen Ihnen verschiedene Methoden zur Verfügung, 
die Sie einzeln oder in Kombination anwenden können: 

• Steuerung über Tasten, wie die Cursortaste oder eine Funktionstaste. 

• Auswahl eines Menüpunktes wie zum Beispiel Sichern per Maus. 

• Menükürzel, über die Kombination von rechter Amiga-Taste und einem Buch¬ 
staben. 

Im folgenden wird die Kombination von rechter Amiga-Tast e und Taste (X) rnit 
B-El abgekürzt. Entsprechend wird die Kombination von [Alt ] -Taste und E 
mit ( Alt I -IY] bezeichnet. 

• Steuerung über die ( Ctrl I -Taste in Kombination mit einem Buchstaben. 

Im folgenden wird die Kombination von Control-Taste und Taste E mit [Ctrl ] - 
E abgekürzt. 

• Anklicken des Bildschirms, wie zum Beispiel in Windows. 

Die Menükürzel wurden so gewählt, daß sie leicht zu merken sind, die Cursor¬ 
tasten basieren auf dem Amiga-Basic-Editor, während die Control-Codes 
WordStar-kompatibel sind, wie bei vielen anderen Editoren auch. Wenn Sie mal 
nicht weiter wissen, bringt ein Druck auf die 1 Help 1 -Taste die Tastenbelegungen, 
falls sie nicht in den Menüs sichtbar sind. 

2.2.2 Einige Worte über Requester 

Der Editor macht extensiven Gebrauch von Requestem. Deshalb ist es ganz nütz¬ 
lich, zu rekapitulieren, wie man damit umgeht. Dies ist besonders für die Eingabe 
von Texten wichtig. Die Editor-Requester enthalten nur Text-Gadgets (Gadget = 
Bedienelement) und Knöpfe. Text-Gadgets erlauben es Ihnen, Text einzugeben und 
zu editieren. Sie erscheinen als Rechteck, das den Text enthält, und als Block, der 
die Cursor-Position anzeigt. Sie müssen dieses Rechteck anklicken, bevor Sie 
irgendein Zeichen eingeben können. Dann können Sie Zeichen einti ppen und edi¬ 
tieren, wozu auch die Cursor-Tasten, die [ Backspace I - und die [ Del ] -Taste genutzt 
werden können. Sie können das ganze Feld mit E-E löschen. Sie können den 
Cursor mit [ Shift ] plus entsprechender Cursor-Taste an den Anfang oder das Ende 
des Feldes bewegen. Wenn sich mehr als ein editierbares Text-Gadget in einem 
Requester befindet, können Sie durch Anklicken mit der Maus hin- und herschalten. 

Knöpfe können mit der Maus angeklickt werden, mit der Folge, daß der Requester 
verschwindet. Meistens gibt es einen Vorzugsknopf, der durch eine doppelte Ein¬ 
rahmung markiert ist. Wird 1 Return I gedrückt, hat das die gleiche Wirkung, als ob 
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Sie vorher ein Text-Gadget durch Klicken aktiviert hätten. In einige Requester 
können nur bestimmte Zeichen eingegeben werden. So akzeptiert der Zeile ...- 
Requester nur Ziffern. 

2.2.3 Datei-Requester 

Mit dem Döfr^Z-Requester können Sie Dateinamen für die Input- und Output¬ 
möglichkeiten von GenAm auswählen. Die einfachste Vorgehensweise besteht 
darin, zuerst die entsprechende Datei und dann OK anzuklicken. Um die gesamte 
Operation abzubrechen, klicken Sie auf Abbruch, Am oberen Rand des Fensters 
befindet sich die »Schubladen«-Funktion, die anzeigt, welche Diskette und welches 
Verzeichnis angezeigt wird. Auch Wildcards sind zulässig für die Eingabe, z.B. 
zeigt 

dfl:examples/#?.s 

alle Dateie n an, d ie auf ».s« enden. Wenn Sie diese Spezifikation editieren wollen, 
geben Sie [ Return ) ein. Das Verzeichnis wird daraufhin gelesen, die entsprechenden 
Dateien werden im Hauptteil der Dialogbox angezeigt. Dateien werden durch einen 
Mausklick und anschließenden Klick auf I Return I ausgewählt. In der Dateiliste 
werden Verzeichnisse durch das Präfix »Dir« angezeigt. Mittels des Scroll-Balkens 
können Sie in der Liste blättern. Im vorliegenden Produkt wird die Datei-Dialogbox 
von Charlie Heath verwendet. Sollte diese Library nicht gefunden werden, wird statt 
dessen ein einfaches String-Gadget verwendet (wie auch schon in der Version 1.0). 
Mehr Details über die ARP-Library finden Sie im ARP-Unterverzeichnis auf Disk 2. 


2.3 Eingabe von Text und Cursor-Bewegungen 

Wenn Sie GenAm geladen haben, sehen Sie ein leeres Fenster mit einer Statuszeile 
am unteren Rand und einen den Cursor darstellenden Block in der oberen linken 
Ecke. 

Die Statuszeile enthält Informationen über die Cursor-Position (Zeile und Spalte) 
sowie die Größe des noch freien Textspeichers in Bytes. Zu Anfang wird letztere 
59980 Byte anzeigen, wenn die voreingestellte Größe von 60 Kbyte gewählt wurde. 
Sie können diesen Voreinstellungswert zusammen mit diversen anderen Optionen 
ändern, wenn Sie in Voreinstellungen gehen. Die »fehlenden« 20 Byte werden vom 
Editor intern belegt. Der Rest der Statuszeile wird für Fehlermeldungen gebraucht, 
die normalerweise mit einem Schirmflackem beginnen, um Sie darauf hinzuweisen. 
Jede Meldung wird entfernt, sobald Sie wieder eine Taste betätigen. 
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Die Texteingabe erfolgt über die Tastatur. Sobald Sie eine Taste drücken, wird das 
auf dem Schirm angezeigt und der Cursor um eine Spalte weiterbewegt. Wenn Sie 
sehr schnell tippen, kann es Vorkommen, daß die Anzeige nicht folgen kann. Aber 
keine Sorge, es geht kein Tastendruck verloren, und die Anz eige ers cheint, sobald 
Sie eine Pause machen. Am Ende einer Zeile können Sie die 1 Return ) - oder 1 Enter) - 
Taste benutzen, um eine neue Zeile zu beginnen. Sie können Fehler mit der 
I Backspace I -Taste korrigieren, welche das Zeichen links vom Cursor löscht, oder mit 
der [ Del I -Taste. die das Zeichen an der Cursor-Position löscht. 

Der Hauptvorteil eines Computer-Editors gegenüber einer konventionellen 
Schreibmaschine ist die Fähigkeit, Dinge zu editieren, die Sie schon lange vorher 
eingegeben haben. GenAm bietet eine Fülle von Optionen, mittels derer Sie sich 
völlig frei im Text bewegen können. 


2.3.1 Cursortasten 

Um den Cursor durch den Text zu bewegen, um Fehler zu korrigieren oder um neue 
Zeichen einzugeben, benutzen Sie die vier Cursortasten. Wenn Sie den Cursor hinter 
das Zeilenende bewegen, fügt der Editor kein Leerzeichen hinzu. Wenn Sie dann ein 
Zeichen tippen, wird es allerdings automatisch an das wirkliche Ende der Zeile 
gehängt. Wenn Sie in sehr lange Zeilen Eingaben machen, rollt das Fenster nach 
rechts. 

Wenn Sie mit (ZI über die erste Zeile des Fensters gehen, rollt der Text entweder 
nach unten (wenn weiter oben noch Text vorhanden ist), oder es erscheint die 
Meldung »Dateianfang«. Ähnlich wirkt (Z am Ende des Textes, hier mit der 
Anzeige »Dateiende«. Für diejenigen unter Ihnen, die Wordstar gewohnt sind: Die 
Tasten I Ctrl l -fsl. I Ctrl l -fPl. [ Ctrl l -fTI. [ Ctrl | -[T| wirken wie die Cursortasten. 

Um den Cursor ein Wort weiter zu bewegen, kombinieren Sie die Tasten [Z/0 mit 
der I Shift I -Taste. Ein Wort ist eine Zeichenkette, abgegrenzt von Leerzeichen, dem 
Tabulator-Zeichen oder an einem Ende durch Zeilenanfang oder Zeilenende. Sie 
können auch die WordStar-Codes I Ctrl 1 -0 un d I Ctrl | -(f 1 einse tzen. Um den Cursor 
eine Seite nach oben zu bewegen, nehmen Sie 1 Shift ) -0 oder [Ctrlj -0. Eine Seite 
nach unten gehen Sie mit I Shift 1 -0 oder 1 Ctrl l -fcl. Wenn Sie den Cursor auf einen 
beliebigen Platz positionieren wollen, können Sie dafür den Mauszeiger nehmen 
und an dieser Stelle die linke Maustaste klicken. (Es gibt in Wordstar kein 
Äquivalent für dieses Feature!) 
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2.3.2 Tabulator-Taste 

Die Tabulator-Taste ( 1 Tab schreibt ein spezielles Zeichen (ASCII-Code 9) in den 
Puffer. Auf dem Schirm erscheint eine Folge von Leerzeichen. [ Tab I justiert den 
Cursor auf die nächste Spalte, die ein Vielfaches von 8 ist. Genauer gesagt: Wenn 
der Cursor am Beginn einer Zeile steht (Spalte 1) und Sie geben iTabl ein, befindet 
sich der Cursor in Spalte 8-1-1, also 9. Tabs sind sehr nützlich, um Wörter unter¬ 
einander zu justieren, weshalb ihre Hauptaufgabe in GenAm auch darin besteht. 
Befehle untereinander zu schreiben. Wenn Sie einen Tab löschen, rückt die Zeile 
auf, als ob die entsprechende Anzahl Leerstellen gelöscht worden wäre. Der Vorteil 
des Tabs ist, daß er nur ein Byte im Speicher belegt. Sie können die Tab-Breite 
ändern, bevor oder nachdem Sie GenAm laden. 

2.3.3 Backspace-Taste 

Die 1 Backspace ] -(Rückschritt-)Taste löscht das Zeichen links vom Cursor. Wenn Sie 
1 Backspace I am Anfang einer Zeile betätigen, löschen Sie das »unsichtbare« CR- 
Zeichen, die Zeile wird an das Ende der vorherigen angefügt. I Backspace I am Ende 
einer Zeile löscht das letzte Zeichen der Zeile, es sei denn, die Zeile ist leer. In 
diesem Fall wird der Cursor nur um ein Zeichen nach links verrückt. 

2.3.4 Delete-Taste 

Die [Del ] -Taste löscht das Zeichen auf der Cursor-Position und hat keinen Effekt, 
wenn der Cursor hinter dem Ende einer Zeile steht. 

2.3.5 Zeile... 

Um den Cursor auf eine bestimmte Zeile (unsichtbare Zeilennummer) zu bewegen, 
wählen Sie Zeile.., aus dem Optionen-Menü oder geben [Ä]-[^ ein. Dann klicken 
Sie das dara uf erscheinende Text-Gadget an und tippen die Zeilennummer, gefolgt 
von [ Return 1 . ein. Sie können auch OK oder Abbruch anklicken, wenn Sie den Befehl 
zurücknehmen wollen. Nach der Auswahl wird der Cursor auf die entsprechende 
Zeile bewegt, die zugehörige Seite wird abgebildet. Wurde die Zeile nicht gefunden, 
erscheint die Meldung »Dateiende«. 

2.3.6 Dateianfang 

Um den Cursor auf die erste Zeile des Textes zu bewegen, wählen Sie Dateianfang 
aus dem Optionen-Mtnü oder geben (T)-[t] oder I Alt l - ftl ein. 
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2.3.7 Dateiende 

Um den Cursor auf die letzte Zeile des Textes zu bewegen, wählen Sie Dateiende 
aus dem Optionen-Mtm oder geben [Ä]-[b] oder 1 Alt | -|T| ein. 

2.4 Verlassen von GenAm 

Um GenAm zu verlassen, wählen Sie GenAm verlassen aus dem Datei-MQWÜ oder 
geben [Ä]-® ein. Falls Text ohne Sicherung auf Disk geändert wurde, erscheint eine 
Alertbox. Klicken Sie dort auf Abbruch, sind Sie wieder im Editor, bei OK hingegen 
verlassen Sie GenAm, die Änderung wird nicht gespeichert. 


2.5 Löschen von Text 

2.5.1 Löschen einer Zeiie 

Die aktuelle Zeile kann mit (Ctrl l -[TI gelöscht werden. Wenn dies die letzte Zeile 
betrifft, wird das Fenster neu gezeichnet. 

2.5.2 Löschen bis zum Ende einer Zeile 

Der Text von der aktuellen Cursor-Position bis zum Ende der Zeile kann mit I Ctrl | - 
5] gelöscht werden. (Dies ist äquivalent zu I Ctrl l -fol-fTl in Wordstar.) 


2.5.3 Gelöschte Zeile wieder einfügen 

Wenn eine Zeile mit obigem Kommando gelöscht wird, wird sie in einem internen 
Puffer gespeichert und kann mit (Ctrl l -m wieder eingefügt werden. Dies kann 
mehrmals wiederholt werden und ist besonders nützlich, wenn Sie eine Zeile auf 
diese Art schnell kopieren wollen. 

2.5.4 Gesamten Text löschen 

Wenn Sie den ganzen Text löschen wollen, wählen Sie Text löschen aus dem Datei- 
Menü oder geben S-El ein. Wenn Sie im Text etwas geändert haben, das noch 
nicht auf Disk gesichert wurde, wird mittels eines Requesters eine Bestätigung ver¬ 
langt. Klicken Sie auf OK, wenn Sie den Text tatsächlich löschen wollen, sonst auf 
Abbruch. 
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2.6 Disketten-Operationen 

Es ist nutzlos, wenn Sie nur Text eintippen, ohne ihn danach abspeichern oder 
wieder laden zu können. Daher besitzt der Editor eine Menge Features, um auf Disk 
abzuspeichem, um ihn wieder laden zu können. 

2.6.1 Text sichern 

Um den Text, den Sie gerade editieren, zu sichern, wählen Sie Sichern als aus dem 
Datei-M^xm oder geben [Ä]-® ein. Es erscheint ein Requester, der Ihnen die Ein¬ 
gabe eines passenden Dateinamens erlaubt. Wenn Sie OK anklicken oder I Return I 
drücken, wird die Datei auf Disk gesichert. Falls dabei ein Fehler auftritt, erscheint 
ein Requester mit einer Meldung oder einer AmigaDOS-Fehlernummer. Deren 
Bedeutung finden Sie in Anhang A. Wenn schon ein File gleichen Namens existiert, 
wird es gelöscht und durch den neuen Inhalt ersetzt. Wenn Sie im Requester 
Abbruch anklicken, wird das File nicht gesichert. Normalerweise wird eine Datei, 
die bereits existiert und den gleichen Namen trägt, gelöscht und durch die neue 
Version ersetzt. Wenn jedoch in den Voreinstellungen Backups gewählt wurde, wird 
ein bereits vorhandenes File umbenannt und erhält die neue Extension .BAK (wobei 
zugleich die alte BAK-Datei gelöscht wird). 

2.6.2 Sichern 

Wenn Sie bereits ein Sichern als (oder ein Laden ...) ausgeführt haben, merkt sich 
GenAm den File- Namen und zeigt ihn als Fenster-Titel an. Mit Sichern aus dem 
Datei-Mtnn oder [ Shift l -CÄl-fsl wird der alte Name einfach wieder eingesetzt. 
Wenn Sie versuchen, mit Sichern zu sichern, ohne vorher einen File-Namen defi¬ 
niert zu haben, erscheint das Requester wie unter Sichern als ... 

2.6.3 Text laden 

Um ein neues Text-File zu laden, wählen Sie Laden ... aus dem Datei-Mtnix oder 
geben [Ä]-[l] ein. Falls Sie das vorhandene File geändert haben, ohne es zu sichern, 
muß eine Bestätigung erfolgen. Der erscheinende File-Requester ermöglicht die 
Eingabe des File-Namens. Angenommen, Sie haben nicht Abbruch gewählt, wird 
der Editor versuchen, das File zu laden. Ist das File zu groß, erscheint die Meldung 
»Zuwenig Speicher«, und das Fenster blinkt kurz auf. Sie sollten dann, wie bereits 
geschildert, den Editor-Puffer größer wählen. 
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2.6.4 Text-File einfügen 

Wenn Sie ein Text-File ab aktueller Cursor-Position einfügen wollen, wählen Sie 
Datei einfügen aus dem Datei-Mtnü oder geben E-Q] ein. Es erscheint der übliche 
File-Requester. Wenn Sie nicht auf Abbruch gehen, wird das File eingelesen, vor¬ 
ausgesetzt, es paßt noch in den Speicher. 

2.6.5 Verzeichnis ändern 

Durch dieses Kommando können Sie das aktuelle Verzeichnis ändern. Benutzen Sie 
einfach die Dialogbox, um in das gewünschte Verzeichnis zu gelangen. 


2.7 Suchen und Ersetzen 

Um einen bestimmten Text zu finden, wählen Sie Suchen aus dem Suchen-Mmü 
oder geben S-E ein. Es erscheint ein Requester, der die Eingabe des Such-Textes 
und - wenn gewünscht - des Ersetz-Textes ermöglicht. Wenn Sie Abbruch an¬ 
klicken, wird die Funktion abgebrochen. Ein Klick auf Nächstes suchen startet die 
Suche vorwärts, ein Klick auf Vorheriges suchen die Suche rückwärts. Wenn Sie 
nicht wollen, daß der gefundene Text durch einen anderen ersetzt wird, also gelöscht 
werden soll, lassen Sie das Ersetz-Feld leer. Wenn die Suche erfolgreich war, wird 
das Fenster neu gezeichnet und der Cursor auf den Anfang des Suchbegriffs gesetzt. 
Wenn der Text nicht gefunden werden konnte, erscheint die Meldung »Nicht 
gefunden« in der Statuszeile, und der Cursor bleibt an der gleichen Position. Bei der 
Suche sind Groß- und Kleinschreibung gleichwertig. Sie können also Test, test oder 
TEST eingeben. 

Um das nächste Vorkommen des gesuchten Strings zu finden, wählen Sie Nächstes 
suchen aus dem Suchen-Menü oder geben E-B ein. Die Suche beginnt an der 
Position direkt nach dem Cursor. Um das vorherige Auftreten des Such-Textes zu 
finden, wählen Sie Vorheriges suchen aus dem Suchen-Menü oder geben E-E ein. 
Die Suche beginnt direkt ab der Cursor-Position. Wurde ein Such-Text gefunden, 
kann er durch den Ersetz-Text ersetzt werden, indem man Ersetzen im Suchen-Mtnü 
anklickt oder E-E eingibt. Nach dem Ersetzen sucht GenAm automatisch nach 
dem nächsten Auftreten des Such-Textes. 

Wenn Sie jedes Vorkommen des gesuchten Textstrings ersetzen wollen, wählen Sie 
Alle ersetzen aus dem Suchen-Menü. Das Menü ist absichtlich so gestaltet, daß ein 
versehentliches globales Ersetzen verhindert wird. Aus diesem Grund gibt es dafür 
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auch kein Tastaturkürzel. Während des Vorgangs k önne n Sie mit der [ Esc I -Taste 
abbrechen. Tabs ersetzen Sie durch Drücken der I Tab I -Taste in der Dial ogbox . 
Andere Control-Zeichen werden mittels direkte r Eingabe gesuc ht (z.B . durch I Ctrl 
©). Dies funktioniert aber nicht bei CR ( I Ctrl ! -[¥]) und bei LF ( I Ctrl l -fTIk 

2.8 Block-Kommandos 

Ein Block ist ein markierter Textbereich, der kopiert, gelöscht, gedruckt oder auf 
Disk geschrieben werden kann. Dafür werden die Funktionstasten benutzt. 

2.8.1 Markieren eines Blocks 

Der Beginn eines Blocks wird markiert, indem man den Cursor auf die ent¬ 
sprechende Stelle bringt und (ID drückt. Das Ende wird markiert, indem man an der 
entsprechenden Stelle dD drückt. Beginn und Ende eines Blocks können in belie¬ 
biger Reihenfolge markiert werden. Ein markierter Block wird hervorgehoben 
dargestellt. Wenn Sie innerhalb eines markierten Blocks eine Zeile editieren, wird 
sie erst dann hervorgehoben, wenn Sie sich aus der Zeile bewegen oder ein 
Kommando eingeben. 

2.8.2 Sichern eines Blocks 

Wenn ein Block markiert ist, kann er mit HD gesichert werden. Wenn kein Block 
markiert ist, erscheint die Meldung »Kein Block markiert«. Liegt der Anfang eines 
Blocks in der Textreihenfolge erst nach dem Ende, erscheint die Meldung 
»Ungültiger Block«. Beide Fehler brechen das Kommando ab. Wenn ein gültiger 
Block markiert ist, erscheint ein File-Requester für die Eingabe eines passenden 
Dateinamens. Wenn Sie einen Namen einer bereits existierenden Datei wählen, wird 
das vorhandene File überschrieben. 

2.8.3 Kopieren eines Biocks 

Ein markierter Block kann auf eine andere Textstelle kopiert werden, indem man 
den Cursor an die entsprechende Stelle bewegt und [fD drückt. Wenn Sie ver¬ 
suchen, einen Block in sich selbst zu kopieren, erscheint die Meldung »Ungültiger 
Block«, und der Vorgang wird abgebrochen. 
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2.8.4 Löschen eines Blocks 

Ein markierter Block k ann mi t ( Shift l - fFn oder I Shift l - (in gelöscht werden. Die 
Kombination mit der I Shift 1 -Taste wurde eingeführt, um ein versehentliches 
Löschen zu vermeiden. Ein gelöschter Block wird im Blockpuffer zwischen¬ 
gespeichert. Um Kompatibilität mit Devpac ST 2.0 und Devpac Amiga 1.0 zu 
gewährleisten, sind zwei Tastenkombinationen für diesen Befehl vorgesehen. 

2.8.5 Block in den Blockspeicher kopieren 

Mit I Shift 1 - 1F4 ] wird ein markierter Block in den Blockspeicher kopiert. Diese 
Funktion ist dann sinnvoll, wenn Sie Textblöcke zwischen verschiedenen Dateien 
austauschen wollen. Dazu laden Sie zuerst eine Datei, kopieren einen Block in den 
Blockspeicher, laden dann die andere Datei und holen den Block wieder aus dem 
Blockspeicher. 

2.8.6 Block einfügen 

Durch Eingabe von (Ts] wird ein Block aus dem Blockspeicher an der Cursor- 
Position eingefügt. Der Blockspeicher geht verloren, wenn die Textspeichergröße 
verändert wird oder assembliert wird. 

2.8.7 Drucken eines Blocks 

Ein markierter Block kann ausgedruckt werden, indem man Block drucken im 
Datei-Mtnü wählt oder [Ä]-[F| eingibt. Ein Requester erscheint, der nach dem 
Druckertyp fragt, wobei PRT: voreingestellt ist. Ein Klick auf OK startet den 
Ausdruck. Natürlich können Sie anstatt PRT: auch jedes andere gültige Peripherie¬ 
gerät angeben, so daß Sie auch den Block in ein Disk-File drucken können. Der 
Unterschied zum Blockspeichem besteht darin, daß die Tab-Zeichen durch die 
entsprechende Anzahl Blanks ersetzt werden. Wenn kein Block markiert ist, wird 
das ganze File gedruckt. 
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2.9 Verschiedenes 

2.9.1 Hilfsbildschirm 

Die entsprechenden Tastenkombinationen für Befehle, die nicht im Menü angeführt 
werden, können durch Drücken der I Help I -Taste oder durch [Ä]-[h] am Bildschirm 
aufgelistet werden, ln der erscheinenden Dialogbox werden auch der insgesamt noch 
freie Speicherplatz und die Versionsnummer von GenAm angegeben. 

2.9.2 Voreinstellungen 

Nach Auswahlen von Voreinstellungen im Optionen-M^vm erscheint eine Dialogbox 
auf dem Bildschirm, die es Ihnen ermöglicht, eine Anzahl von Editor-Einstellungen 
zu bestimmen: 

Tabulatoren ändern 

Die Voreinstellung für den Tabulator ist 8, kann aber während des Editierens durch 
die Wahl von Tababstand aus dem Voreinstellungen-Mtnü geändert werden. Es 
erscheint ein Requester, der die aktuelle Einstellung zeigt. Diese kann auf einen 
Wert zwischen 2 und 16 geändert werden. 

Größe des Textpuffers 

Die Grundeinstellung des Textpuffers beträgt 60 Kbyte, sie kann jedoch auf 4 Kbyte 
bis 999 Kbyte eingestellt werden, was die maximale Größe einer zu ladenden und 
editierenden Datei begrenzt. Sie sollten allerdings darauf achten, daß noch genügend 
Platz zum Speichern und für MonAm übrigbleibt. Eine Änderung des Arbeits¬ 
speichers des Editors führt dazu, daß jeder Text, der gerade editiert wird, verloren¬ 
geht. Vorher wird jedoch eine Sicherheitsabfrage gemacht. 

Backups 

Per Grundeinstellung macht der Editor bei der Abspeicherung von Programmen 
keine Backups, dieses kann jedoch durch Klicken auf Ja in der Voreinstellungen- 
Box geändert werden. 

Automatisches Einrücken 

Es dient der Übersichtlichkeit beim Editieren von Programmen - sowohl in 
Assembler als auch in Hochsprachen Folgezeilen nach rechts einzurücken. Der 
Editor unterstützt dieses automatische Einrücken. Wenn es aktiviert ist, wird nach 
jedem 1 Return 1 zu Beginn einer neuen Zeile soviel an Leerraum (Tabs und Blanks) 
eingefügt, wie sich auch am Anfang der vorherigen Zeile befanden. 
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Zeilenende 

Per Grundeinstellung bewegt sich der Cursor nicht nach links, wenn er sich bereits 
am linken Zeilenrand befindet. Ebenso kann er durch Q nicht bewegt werden, wenn 
er am Ende einer Zeile steht. Durch Anklicken von Umbruch kann diese Vorein¬ 
stellung dahingehend modifiziert werden, daß der Cursor am Zeilenende auch nach 
rechts wandern kann bzw. am Zeilenanfang nach links. 

MonAm laden 

Während der Initialisierung des Editors wird eine Kopie von MonAm automatisch 
geladen und ist per Tastendruck verfügbar. Sollte dies nicht erwünscht sein - Sie 
könnten ja auch dadurch 24 Kbyte Speicherplatz sparen -, kann die Voreinstellung 
durch diese Option geändert werden. Diese Änderung wird erst dann wirksam, wenn 
Sie die Voreinstellungen speichern und den Editor wieder aufrufen. 

Volle Größe (autom.) 

Per Grundeinstellung benutzt GenAm nicht den gesamten Bildschirm, dies kann 
aber durch Auswahl dieser Option dahingehend modifiziert werden, daß das Initiali¬ 
sierungsfenster so groß wie möglich erscheint. 

Voreinstellungen speichern 

Wenn Sie auf OK klicken, sind alle Voreinstellungen bis zum nächsten Aufruf des 
Editors wirksam. Wenn Sie die Konfiguration dauerhaft speichern wollen, klicken 
Sie Sichern an. Dadurch wird die Datei GENAM2.INF auf Disk gespeichert. Wenn 
Sie GenAm das nächste Mal aufrufen, wird die Konfiguration von dieser Datei 
eingelesen. Zusätzlich werden die Einstellungen der Assembler-Optionen 
abgespeichert. 


2.10 Assemblierer! und Programm ablaufen lassen 

Alle Assemblier- und Ausführ-Optionen sind im Programm-Menü zu finden. 


2,10.1 Assemblieren 

Um das Programm zu assemblieren, das Sie gerade editieren, klicken Sie auf 
Assemblieren ... im Programm-Menü oder geben H-S ein. Die Bedeutung dieser 
verschiedenen Optionen und des Assemblierprozesses wird in Kapitel 3.2 
beschrieben. Die einzige Option, die an dieser Stelle behandelt wird, ist die Output- 
Option. 



36 Kapitell 


GenAm kann auf Diskette^ in den Speicher oder Nirgendwohin assemblieren - wenn 
Sie nur einen Syntaxcheck machen wollen, bietet sich die Option Nirgendwohin an, 
während Assemblieren in den Speicher ideal dafür ist, schnell etwas auszuprobieren. 

Wenn Sie auf Disk assemblieren und Ihr Programm nicht unter einem bestimmten 
Namen abgespeichert haben, wird es automatisch unter NONAME gespeichert. 

Nach dem Klicken auf Assemblieren ... oder Eingabe von [ Return | beginnt der 
Assemblierungsprozeß. Am Ende der Assemblierung wartet das Programm auf 
einen Tastendruck und gibt Ihnen so die Möglichkeit, Meldungen zu lesen, bevor 
Sie in den Editor zurückkehren. Falls Fehler vorhanden sind, springt der Cursor in 
die erste fehlerhafte Zeile, die Fehlermeldung wird in der Statuszeile dargestellt. 
Nachfolgende Fehler (und Warnungen) werden nach Eingabe von [Ä]-(T) 
ausgegeben. 

2.10.2 Ablauf von Programmen 

Wenn Sie auf Ausfuhren ... im Programm-Menü klicken oder (T)-(Y) (eXecute) ein¬ 
geben, können Sie ein in den Speicher assembliertes Programm ablaufen lassen. 
Nach Beendigung des Programms kehren Sie in den Editor zurück. Wenn die 
Assemblierung nicht ordnungsgemäß beendet wurde, kann das Programm nicht 
ablaufen. Da Sie nach einem Absturz nicht mehr in den Editor zurückkehren 
können, empfiehlt es sich, den Source-Code vor dem Programmablauf zu sichern. 

Warnung: Wenn während der Assemblierung nur nichtfatale Fehler wie z.B. 
Undefinierte Symbole aufgetreten sind, können Sie das Programm zwar ablaufen 
lassen, jedoch kann nicht garantiert werden, daß dies ordnungsgemäß geschieht. 

2.10.3 Debuggen 

Wenn Sie ein zuvor in den Speicher assembliertes Programm debuggen wollen, 
klicken Sie auf Debuggen im Programm-Menü oder geben [TJ-O ein. Dadurch 
startet der Debugger, durch Eingabe von [ Ctrl l -fcl in MonAm wird das Debuggen 
wieder beendet. 

Hinweis: Wenn die Option MonAm nicht eingeschaltet ist, kann diese Option nicht 
angewählt werden. 

2.10.4 MonAm 

Ein Klick auf MonAm im Programm-Menü oder die Eingabe von (T)-® ruft 
MonAm genauso auf, als ob es vom CLI aus durch Eintippen des Programmnamens 
aufgerufen worden wäre. Der Unterschied besteht jedoch darin, daß es sich in erster 
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Aufrufmöglichkeit bereits im Speicher befindet. Sie kehren in den Editor zurück, 
wenn Sie das Debuggen beenden. 

Hinweis: Wenn die Option McmAm nicht eingeschaltet ist, kann diese Option nicht 
angewählt werden. 

2.10.5 Anspringen der Fehlerzeile 

Während des Assemblierens werden die ersten 30 Fehler und ihre Zeilennummern 
in einem Puffer gespeichert. Wenn Sie zum Editor zurückkehren, können Sie diese 
Zeilen schrittweise abarbeiten (ändern), indem Sie Nächster Fehler aus dem 
Optionen-Mtnü wählen oder E-CZ) eingeben. Dies bewegt den Cursor auf die näch¬ 
ste Zeile, in der ein Fehler festgestellt wurde, und zeigt die Fehlermeldung in der 
Statuszeile an. Wenn Sie irgendwelche Änderungen vornehmen, die die Anzahl der 
Textzeilen ändern, wird der Fehlerpuffer gelöscht. Wenn keine Fehler mehr 
vorhanden sind, erscheint die Meldung »Welche Fehler!«. 


2.11 Das Editor-Fenster 

Das Fenster, das der Editor nutzt, funktioniert wie die meisten anderen Amiga- 
Fenster. So können Sie es mit dem Verschiebe-Gadget am oberen Rand ver¬ 
schieben. Sie können seine Größe mit dem Größen-Gadget links unten ändern. Sie 
können seine Lage relativ zu den anderen Fenstern ändern, indem Sie auf das Front¬ 
beziehungsweise Back-Gadget rechts oben klicken. Wenn Sie das Schließ-Gadget 
links oben anklicken, hat das denselben Effekt, als ob Sie GenAm verlassen aus dem 
Datei-Mtnü wählen oder H-® eingeben. 

Wie alle Intuitions-Fenster muß auch dieses vor einer Eingabe oder Menüwahl akti¬ 
viert werden (irgendwo im Fenster klicken). Wenn Sie einen größeren Bildschirm¬ 
bereich als normal haben, wie zum Beispiel bei den europäischen PAL-Versionen 
(256 anstatt 200 Zeilen), können Sie das Fenster auf die volle Schirmgröße ziehen. 
Wenn GenAm während eines Diskzugriffs oder während des Assemblierens 
beschäftigt ist, erscheint anstelle des Mauszeigers eine Sanduhr, Menüpunkte sind 
licht dargestellt. 
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Kapitel 



Der Makro-Assembler 


3.1 Einführung 

GenAm ist ein mächtiger, schneller Assembler, der mit dem Editor gekoppelt ist 
oder auch als alleinstehendes Programm aufgerufen werden kann. Er wandelt Text, 
der in den Editor eingetippt oder geladen wurde, zusammen mit optional von der 
Disk nachladbaren Texten in ein Binär-File um, wahlweise als linkbaren oder sofort 
ausführbaren Code. 

3.2 Den Assembler aufrufen 

3.2.1 Vom Editor aus 

Sie können den Assembler vom Editor aus durch Wählen der Assemhlieren-¥\xnk- 
tion im Programm-Mtnü oder mit B-E aufrufen. Eine Dialogbox erscheint: 


Ausführbar 


ildschip 


Nornal 


ypuckep 


PpograHhtyp 
GroP/Klein 
Debug-Infornation | 
Listiiurj 
AsseHbliepen 
Output 


. iskette: I I 

_Assenblep Optionen 

I Abbruch | fki 


Linkable 


Gleich 


Export. 


Diskette 


Langsah 


Speichep 


Assenbliepenl 
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Programmtyp 

Hier wählen Sie zwischen ausführbarem oder linkbarem Code. Die Unterschiede 
zwischen den Programmtypen werden später genau erklärt. 

Groß/Klein 

Hier können Sie wählen, ob in Symbolen Unterschiede in der Groß- oder Klein¬ 
schreibung gemacht werden sollen. Wenn Sie Gleich wählen, sind die Symbole 
»Start« und »Start« gleichwertig; wenn Verschieden gewählt wird, werden sie als 
verschiedene Symbole behandelt. 

Debug-Information 

Wenn Sie Ihr Programm noch debuggen, sollten im fertigen Programm Symbole 
enthalten sein. Die Symboloptionen sind Normal und Erweitert: das HiSoft-erwei- 
terte Debug-Format erlaubt es, bis zu 22 Zeichen lange Symbole anstatt der üblichen 
8 Zeichen Länge zu verwenden. 

Listing 

Sie können hiermit die Ausgabe des Listings wählen: auf Drucker oder auf Diskette, 
auf der eine Datei mit gleichem Namen und der Extension .LST angelegt wird. 
Wenn Sie keine Ausgabe wollen, wählen Sie Nein. 

Assemblierer! 

Hier können Sie die Geschwindigkeit des Assemblers bestimmen. Normalerweise 
sollten Sie den Schnell-Bution betätigt lassen, wenn jedoch der Speicherplatz zu 
gering wird, sollten Sie Langsam wählen. Dadurch wird der Assembler gezwungen, 
so wenig Platz wie möglich zu belegen und den Zugriff auf Diskette zu ver¬ 
langsamen. 

Output 

Wie bereits erwähnt, können Sie hier wählen, welches Programm aus Ihrem Quell¬ 
text erzeugt wird. Nein heißt, daß nur ein Syntaxcheck gemacht und kein Programm 
erzeugt wird. Speicher bedeutet, daß das Programm in den Speicher assembliert 
wird und so bereitsteht, um von MonAm debuggt oder auch einfach zur Ausführung 
gebracht zu werden. Es erfolgt kein Diskettenzugriff, außer wenn eine Include-Datei 
gebraucht wird, die meistens nur einmal gelesen wird. Diskette bedeutet, daß das 
Programm, wie gewohnt, auf Diskette erzeugt wird. Die Regeln der Namensgebung 
für die Dateien werden in Kürze erläutert. Wenn Sie alle gewünschten Optionen 
gewählt haben, klicken Sie auf Assemhlieren oder drücken I Return I . 
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3.2.2 Der Stand-alone-Assembler 

Format der Kommandozeile 

Die Kommandozeile hat das Format 
Genlm2 Hauptdatei <-0ptionen> [-Optionen] 

Hauptdatei ist der Name der Datei, die assembliert werden soll; wenn keine Exten¬ 
sion angegeben wurde, wird .S angenommen. Optionen sollte ein »-« voranstehen. 
Erlaubte Optionen sind (zusammen mit den äquivalenten OPT-Direktiven): 

B keine Binärdatei erzeugen 
C Groß-/Kleinschreibung gleichwertig (OPT C-) 

D Debug (OPT D+) 

L linkbarer Code (OPT L+) 

M Langsam als Assembliermodus (Vorsicht: nicht identisch mit OPT M+) 

0 Name der erzeugten Datei, folgt dem O ohne Leerschritt 
P Name der Listing-Datei, folgt dem P ohne Leerschritt 
Q In jedem Fall auf einen Tastendruck am Ende warten 
T Der Tab-Abstand; die Zahl folgt dem T ohne Leerschritt; z.B. benutzt -TIO 
einen Tab-Abstand von 10 

X Erweiterter Debug (OPT X+). Wird dann gebraucht, wenn bei der Gene¬ 
rierung linkbaren Codes nur die exportierten Symbole exportiert werden 
sollen (OPT X+) 

Die in Genlm2 verwendeten Optionen unterscheiden sich von denen der Version 1! 
Wenn keine Optionen in der Kommandozeile angegeben werden, wird eine aus¬ 
führbare Programm-Datei erzeugt, deren Namen auf dem der Source-Datei basiert, 
allerdings ohne Listing und mit Unterscheidung zwischen Groß- und Klein¬ 
schreibung. Beispiele: 

genim2 test -b assembliert die Datei TEST.S, ohne eine binäre 

Ausgabedatei zu erzeugen; dies wäre ein Syntax¬ 
check, mehr nicht. 

genim2 test -oramitest -p assembliert TEST.S in die Datei RAM:TEST und 

erzeugt eine Listing-Datei namens TEST.LST. 
genim2 test -Idpprt: assembliert TEST.S in linkbares Format mit voll¬ 

ständiger Debug-Information und schickt das 
Listing an die parallele Schnittstelle. Wenn Sie ein 
Listing an die serielle Schnittstelle senden wollen, 
müssen Sie AUX: angeben. Der Tab-Abstand des 
Listings beträgt 10 Zeichen. 
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Dateinamen 

In GenAm ist geregelt, wie der Name einer Ausgabedatei kreiert wird. Der Name ist 
außerdem abhängig von den angegebenen Optionen, wie z.B. -O, und der Output- 
Direktive. 

Wenn ein Dateiname explizit angegeben wird, ist 

Name=angegebenerName 

wenn die Output-Direktive nicht benutzt wurde, ist 

Name=Source-Name + .PRG, .BIN oder .0 

wenn die Output-Direktive eine Extension angibt, ist 

Name=Source-Name + Extension vom Output 

sonst ist 

Name=Name vom Output 

Der Assembliervorgang 

Genim ist ein Zwei-Paß-Assembler; während des ersten Passes wird der Quelltext 
im Speicher, ggf. auch von Diskette, verarbeitet und eine Symboltabelle gebildet. 
Wenn Syntaxfehler während des ersten Passes gefunden wurden, werden diese 
angegeben, der zweite Paß wird nicht gestartet. Während des zweiten Passes werden 
die mnemonischen Befehle in binäre Instruktionen umgewandelt, ein Listing kann 
ausgegeben - wenn erforderlich mit einer Symboltabelle - und eine Binärdatei 
erzeugt werden. Während des zweiten Passes gefundene Fehler und Warnungen 
werden angegeben. Während des Assemblierens kann jede Bildschirmausgabe durch 
Drücken eine r belie bigen Taste angehalten und mit [ Return 1 weiterlaufen gelassen 
werden. Mit [ Ctrl l -fcl kann der Assembler abgebrochen werden; die bis dahin 
erzeugte Binär-Datei ist aber unvollständig und sollte nicht ausgeführt werden. 

In den Speicher assemblieren 

Um die Tum-around-Zeiten so gering wie möglich zu halten, kann GenAm in den 
Speicher assemblieren, so daß Ihr Programm sofort ausgeführt oder vom Editor 
sofort debuggt werden kann. Ein vom Speicher aus ablaufendes Programm verhält 
sich wie ein normales Programm und sollte lediglich mit einer RTS-Anweisung mit 
dem Stack, von dem aus in das Programm gegangen wurde, enden. Programme, die 
ein weiteres Mal ausgeführt wurden, modifizieren sich selbst und befinden sich in 
dem Zustand nach der letzten Ausführung. Wenn Sie Voreinstellungen speichern 
wählen, wird die aktuelle Assemblieroption zur Standardeinstellung gemacht. 
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3.3 Binäre Dateitypen 

GenAm erzeugt zwei Dateitypen, die je nach Art der Applikation benötigt werden. 
Ihre Unterscheidung basiert auf der Extension des Dateinamens: Wenn keine Exten¬ 
sion vorhanden ist, liegt eine direkt ausführbare Datei vor, wenn die Extension .0 
oder .OBJ lautet, liegt ein AmigaDOS-linkbares File vor. 

Es gibt zwei Arten von ausführbaren Dateien: diejenigen, die vom CLI aus laufen, 
und die, die von der Workbench aus laufen. Der Unterschied liegt im Code, der ein 
Teil des Programms ist; der Assembler erkennt den Unterschied nicht. Anhang C.4 
geht näher darauf ein. .O-Dateien können nicht sofort ablaufen, sondern müssen 
gemeinsam mit weiteren Sektionen in einen Linker eingelesen werden. Sie werden 
als linkbare Objektmodule bezeichnet. 


3.4 Codearten 

Wie in den meisten 16-Bit-Systemen wird unter AmigaDOS ein ausführbares Pro¬ 
gramm nicht an eine bestimmte Adresse geladen, sondern an eine solche Adresse, 
die von dem zu diesem Zeitpunkt freien Speicherplatz abhängig ist. Um das 
Problem der absoluten Adressierung in den Griff zu bekommen, enthält das Datei¬ 
format Relozierinformationen, die AmigaDOS erlauben, das Programm nach dem 
Laden, jedoch vor dem Ablauf, zu relozieren. Zum Beispiel setzt der folgende 
Programmteil 

move.l #string,aO 


String dc.b 'Press any key',0 

die absolute Adresse von »string« in ein Register, obwohl zur Assemblierzeit die 
Adresse von »string« nicht bekannt sein kann. Im allgemeinen kann der Program¬ 
mierer Adressen auch dann als absolut behandeln, wenn er die wirklichen Adressen 
nicht kennt, während der Assembler (oder Linker) die notwendige Relozierinfor- 
mation besorgt. 

Hinweis: In manchen Programmen, Spielen oder für Entwicklungen auf mehreren 
Maschinen sind absolute Startadressen erforderlich. Aus diesem Grund wird die 
ORG-Direktive unterstützt. 
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3.5 Assembler-Befehlsformat 

Jede Zeile, die der Assembler verarbeiten soll, muß folgendes Format besitzen: 

Label-Feld Mnemonik-Feld Operanden-Feld Kommentar-Feld 

Start move.l dO,(aO)+ Ergebnis speichern 

Ausgenommen von dieser Regel sind Kommentarzeilen, die mit einem Stern (*) 
gekennzeichnet sind, und Leerzeilen, die ignoriert werden. Jedes Feld muß vom 
nächsten durch einen Zwischenraum getrennt sein, wofür jede Kombination von 
Leer- und Tab-Zeichen erlaubt ist. 

3.5.1 Das Label-Feld (Markenfeld) 

Ein Label (Marke) beginnt normalerweise in Spalte 1, aber wenn es nötig erscheint, 
es in einer anderen Spalte beginnen zu lassen, muß im direkten Anschluß ein 
Doppelpunkt (:) folgen. Labels sind grundsätzlich in allen Zeilen mit Befehlen 
erlaubt, jedoch bei einigen Assembler-Direktiven verboten, bei anderen wiederum 
sind sie Pflicht. 

Alle Labels müssen mit einem der Zeichen a..z, A..Z, Umlauten oder dem Unter¬ 
strich (_) beginnen. Danach sind noch die Zeichen 0..9 und der Punkt erlaubt. 
Makro-Namen und Register-Equates dürfen keinen Punkt enthalten. Labels, die mit 
einem Punkt beginnen, und Zahlensequenzen, die mit einem $ abgeschlossen sind, 
sind lokale Labels. Standardmäßig sind die ersten 127 Zeichen eines Labels signi¬ 
fikant, diese Anzahl kann jedoch reduziert werden. Labels sollten nicht die gleichen 
Namen wie Register tragen, ebenso nicht erlaubt sind die Namen der reservierten 
Wörter SR, CCR oder USP. Kleinbuchstaben werden normalerweise von den ent¬ 
sprechenden Großbuchstaben unterschieden, solange dies nicht über die Opt-C- 
Direktive verändert wird. 

Einige Beispiele für korrekte Labels: 

fest, Test, TEST, _test, _test.end, testS, _5test 

Beispiele für inkorrekte Labels: 

.fest, Btest, _&e, test> 

In GenAm gibt es nur die reservierten Symbole _LK, _RS und _G2, die mit dem 
Unterstrich beginnen. 
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3.5.2 Das Mnemonik-Feld 

Das Mnemonik-Feld folgt dem Label-Feld und kann 68000-Befehle, Assembler- 
Direktiven oder Makro-Aufrufe enthalten. Einige Befehle und Direktiven erlauben 
die Typangabe mittels .B für Byte, .W für Wort und .L für Langwort sowie .S für 
Short. Was wann erlaubt ist, hängt vom jeweiligen Befehl beziehungsweise von der 
Direktive ab. GenAm ignoriert die Groß-/Kleinschrift-Unterscheidung bei Befehlen 
und Direktiven, weshalb move, MOVE und mOve als gleichwertig betrachtet 
werden. 


3.5.3 Das Operanden-Feld 

Für Befehle und Direktiven, die Operanden erfordern, enthält dieses Feld ein oder 
mehrere durch Kommas getrennte Parameter. Registemamen können groß oder 
klein geschrieben werden, das heißt, SP und sp sind identisch und gültige Namen für 
Stack-Zeiger. 


3.5.4 Das Kommentar-Feld 


Jedes Leer- oder Tab-Zeichen, das nicht in Anführungszeichen steht und das nach 
dem zu erwartenden Ende von Operand(en) gefunden wird, wird als Beginn des 
Kommentar-Feldes betrachtet, das der Assembler ignoriert. 

Hinweis des Übersetzers: Vermeiden Sie unbedingt Leerstellen zwischen den Ope¬ 
randen, weil der Assembler dies als Kommentarbeginn auffaßt. Speziell bei Auf¬ 
listungen nach DC kann das problematisch werden. Mindestens ein Leerzeichen 
(oder Tab) ist obligatorisch. 

rts ;das ist OK 
rts;das ist falsch 


Beispiel für gültige Zeilen: 


move.1 
loop TST.W 
nur.1abel 
rts 

* das ist eine 
; eingerückt: 
a_string: dc.b 


dO,(aO)+ Kommentar hier 

dO 


reine Kommentar-Zeile 
link A6,#-10 schaffe Platz 
'Leerstellen in Hochkommas erlaubt' String 
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3.5.5 Ausdrücke 

GenAm erlaubt komplexe Ausdrücke und unterstützt voll die Operatoren-Priorität, 
Klammem und logische Operatoren. Es gibt zwei Arten von Ausdrücken: absolute 
und relative. Dieser Unterschied ist wichtig. Absolute Ausdrücke sind Konstanten, 
die dem Assembler bekannt sind. Relative Ausdrücke sind (ergeben) Programm¬ 
adressen, die während des Assemblierens nicht bekannt sind, weil das Programm 
vom AmigaDOS-Lader an eine beliebige Stelle im Speicher verlagert werden kann. 
Für einige Befehle und Direktiven gibt es Einschränkungen hinsichtlich des erlaub¬ 
ten Typs, einige Operatoren können nicht mit bestimmten Typ-Kombinationen 
benutzt werden. 

Operatoren 

Die zur Verfügung stehenden Operatoren - in absteigender Priorität - sind: 
Monadisches Minus(-) und Plus ( 4 -) als Vorzeichen 
Bitweises NOT (~) 

Links («) und rechts(») schieben 
Gleichheit (=); Größer als (>); Kleiner als (<) 

Bitweises AND (&), OR (!) und XOR(^) 

Multiplikation (*) und Division (/) 

Addition (-I-) und Subtraktion (-) 

Die Vergleichsoperatoren liefern als Wert 0, wenn der Ausdruck falsch ist bzw. -1 
($FFFFFFFF), wenn er wahr ist. Die Shift-Operatoren verschieben den links stehen¬ 
den Operator um die Anzahl der im rechten Operator angegebenen Bits, die Leer¬ 
stellen werden mit Nullen aufgefüllt. Die Priorität kann durch die Klammem () auf¬ 
gehoben werden. Ausdrücke mit Operatoren gleicher Priorität werden von links 
nach rechts entwickelt. Leerstellen in Ausdrücken (ausgenommen in Strings in 
Hochkommas) sind nicht erlaubt, weil sie als Trennzeichen zum nächsten Feld auf¬ 
gefaßt werden. Alle Ausdrücke werden in 32-Bit-Arithmetik mit Vorzeichen 
gerechnet, es findet kein Test auf Überlauf statt. 

Zahlen 

Absolute Zahlen sind in verschiedenen Darstellungen möglich als 

Dezimale Konstanten, z.B. 1029 

Hexadezimale Konstanten, z.B. $12f 

Oktale Konstanten, z.B. @730 

Binäre Konstanten, z.B. % 1000101 

Zeichen-Konstanten, z.B. ’X’ 

$ bezeichnet hexadezimale, % binäre, @ oktale Zahlen und ’ oder " Zeichen-Kon¬ 
stanten. 
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Zeichen-Konstanten 

Ob Anführungszeichen oder Hochkommas zur Stringabgrenzung benutzt werden, ist 
unbedeutend, jedoch müssen die Zeichen zu Beginn und Ende des Strings die 
gleichen sein. Zeichen-Konstanten können bis zu 4 Zeichen lang sein und werden 
rechtsbündig und mit führenden Nullen dargestellt, wenn erforderlich. Hier einige 
Beispiele mit den zugehörigen ASCII- und Hex-Äquivalenten: 


"Q" 

Q 

$00000051 

’hi’ 

hi 

$00006869 

"Test" 

Test 

$54637374 

"it’s" 

it’s 

$6974277C 

’it”s 

it’s 

$6974277C 


Strings in DC.B-Direktiven unterliegen leicht unterschiedlichen Regeln, was später 
noch gezeigt wird. Die in Ausdrücken verwendeten Symbole sind Je nach Definition 
relativ oder absolut. Labels im Source sind relativ, wohingegen diejenigen, die 
mittels der EQU-Direktive verwendet wurden, dem Ausdruckstyp gleich sind, dem 
sie gleichgesetzt wurden. Ein Asterix (*) zeigt den Wert des Zählers am Programm¬ 
anfang an und ist immer relativ. 

Erlaubte Typ-Kombinationen 

Symbole in Ausdrücken werden entweder relativ oder absolut »entwickelt«, was 
davon abhängt, wie sie definiert wurden. Labels innerhalb des Programmbereichs 
(zu Befehlen) sind relativ, während solche auf EQU-Direktiven den Typ des 
zugewiesenen Wertes annehmen. Die folgende Tabelle faßt zusammen, welche Typ- 
Kombinationen zu welchem Resultat führen. Es bedeuten: 

R Relativ 

A Absolut 

* Kombination ist nicht erlaubt, erzeugt Fehlermeldung. 


1_ 

Aop A 

Aop R 

Rop A 

Rop R 


A 

* 

* 

* 

Bitwise operators 

A 



* 

Multlply 

A 

* 

* 

* 

Divlde 

A 

* 

* 

* 

Add 

A 

R 

R 

« 

Subtract 

A 

* 

R 

A 

Comparisons 

A 

* 

* 

A 
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Adressierungsarten 

Die verfügbaren Adressierungsarten zeigt die folgende Tabelle. Bitte beachten Sie, 
daß GenAm beim Abarbeiten der Adressierungsarten Groß-/Kleinbuchstaben nicht 
unterscheidet, weshalb zum Beispiel sowohl DO als auch a3 gültige Registemamen 
sind. 


Form 

Bedeutung 

Beispiel 

Dn 

Datenregister direkt 

D3 

An 

Adreßregister direkt 

A5 

(An) 

Adreßregister indirekt (ARI) 

(Al) 

(An)+ 

ARI mit Postinkrement 

(A5)+ 

-(An) 

ARI mit Prädekrement 

-(AO) 

d(An) 

ARI mit Offset 

20(A7) 

d(An,Rn.s) 

ARI mit Index 

4(A6,D4.L) 

d.W 

Absolut kurz 

$0410.W 

d.L 

Abolut lang 

$12000.L 

d(PC) 

PC-relativ mit Offset 

NEXT(PC) 

d(PC,Rn.s) 

#d 

PC-relativ mit Offset und Index 
Konstante 

NEXT(PC,A2.W) 


Hierin bedeuten: 

ARI: Adreßregister indirekt : 

n: Eine Zahl von 0 bis 7 

d: Eine Zahl 

R: Indexregister A oder D 

s: Typ W oder L; W, wenn nicht angegeben 

Wenn Adreßregister indirekt mit Index verwendet werden, kann der Offset weg¬ 
gelassen werden. Zum Beispiel wird »move.l (a3,d2.1),dO« zu »move.l 
0(a3,d2.1),d0«. 

Spezielle Adressierungarten 

CCR Condition Code Register (User-Byte des Statusregisters) 

SR Status-Register 

USP User Stack Pointer 

Zusätzlich kann SP anstatt Al in allen oben aufgeführten Adressierungsarten ein¬ 
gesetzt werden, z.B. 4(SP.D3.W). Daten- und Adreßregister können auch durch die 
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reservierten Symbole RO bis R15 ausgedrückt werden. RO und R7 sind äquivalent 
mit DO bis D7, R8 bis R15 sind äquivalent mit AO bis A7. Dies ist aus Kompati¬ 
bilitätsgründen zu anderen Compilern der Fall. 

3.5.6 Lokale Labels 

GenAm unterstützt lokale Labels; das sind Labels, die einem bestimmten Teil des 
Sources angehören. Sie beginnen mit einem Punkt (».«) und sind vom vor¬ 
hergehenden nicht-lokalen Label abhängig. 

längel move.l 4(sp),a0 
.loop tst.b (a0)+ 
bne.s .loop 
rts 

länge2 move.l 4(sp),a0 
.loop tst.b “(aO) 
bne.s .loop 
rts 

Es gibt zwei Labels namens ».loop«, von denen das erste zu »längel«, das zweite zu 
»länge2« gehört. Um Verwechslungen mit der absoluten Adressierungsart zu ver¬ 
meiden, sind ».w« und ».1« nicht als lokale Labels zulässig. Wenn Sie globale 
Labels verwenden wollen, die mit einem Punkt beginnen, müssen Sie OPT U+ ver¬ 
wenden, und mit dem Unterstrich lokale Labels einführen. 

Lokale Labels des Amiga-Makro-Assemblers 

Ebenso können Strings von Zahlen, die mit »$« abgeschlossen sind, als lokale 
Labels verwendet werden. Diese Eigenschaft besteht, um Kompatibilität mit 
anderen Assemblern zu gewährleisten. Wir empfehlen Ihnen die oben angegebene 
Form, um das Programm lesbar zu machen. 

Symbole und Punkte 

Symbole, die das Punkt-Zeichen enthalten, können in GenAm zu Problemen bei der 
absolut kurzen Adressierung und bei Register-Equates führen. Der Motorola- 
Standard zur Kennzeichnung der Kurzadressierung verursacht Probleme, weil 
Punkte auch in einem Label auftreten können, wie ein Beispiel am besten zeigt: 
move.w vector.w.dO 

Dabei ist »vector« ein absoluter Wert, wie zum Beispiel eine Systemvariable. Da ein 
Label erwartet wird, wird die Fehlermeldung »undefined label« erzeugt. Um dies zu 
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vermeiden, sollte der Ausdruck, in diesem Fall ein Symbol, in Klammem gesetzt 
werden, wie z.B. 
move.l (vector).w,d0 

Der Punkt kann jedoch weiterhin nach numerischen Ausdrücken benutzt werden, 
wie z.B. 
move.l $4.w,d0 

Hinweis: Gen Ami und GenAm2 unterstützen in der Kurzwortadressierung anstatt 
des Punktes auch den »\«, allerdings sollte diese Adressiemngsart aufgrund der 
Verwechslungsmöglichkeiten in Makroparametem vermieden werden. 


3.6 Der Befehlssatz 

3.6.1 Wortgrenzen 

Alle Anweisungen außer DC.B und DS.B werden auf Wortgrenze assembliert. Falls 
Sie jedoch DC.B explizit auf einer Wortgrenze verwenden wollen, sollten Sie zuvor 
ein EVEN setzen. Obwohl alle Anweisungen, die es erfordern, auf Wortgrenze 
liegen, können Labels, denen nichts folgt, ungerade Werte haben und liegen nicht 
auf Wortgrenze. Dies wird am besten durch ein Beispiel gezeigt: 

nop ist immer auf Wortgrenze 
dc.b 'ungerade' 

Start 

tst.l (a0)+ 
bne.s Start 

Da »Start« einen ungeraden Wert besitzt, würde hier das gewünschte Ergebnis nicht 
erzielt werden. Der Assembler gibt jedesmal, wenn bei einem BSR- oder BRA- 
Operanden eine ungerade Adresse gefunden wird, eine Fehlermeldung aus. Beach¬ 
ten Sie dabei, daß eine derartige Überprüfung nicht bei anderen Anweisungen statt¬ 
findet. Sie sollten also eine EVEN-Direktive voransetzen, wenn die Labels auf 
Wortgrenze liegen sollen. Hier unterlaufen leicht Fehler, da ja der vorhergehende 
String eine gerade Anzahl von Bytes lang ist. Wenn jedoch der String geändert wird, 
kann es Probleme geben. 

Erweiterungen des Befehlssatzes 

Der vollständige 68000-Befehlssatz wird von GenAm2 unterstützt. Es gibt aber 
einige stilistische Abkürzungen, die GenAm2 auch akzeptiert: 




Der Makro-Assembler 51 


Condition Codes 

Die alternativen Condition Codes HS und LQ, äquivalent mit CC und CS, werden 
bei Bcc-, DBcc- und Scc-Instruktionen unterstützt. 

Branch-Befehle 

Um einen kurzen Branch explizit anzugeben, benutzen Sie Bcc.B oder Bcc.S. Einen 
Branch mit Wort-Länge geben Sie mit Bcc.W an; Sie können aber auch den Opti- 
mierer die Branch-Länge wählen lassen. Bcc.L wird aus Kompatibilitätsgründen zu 
Gen Ami beibehalten, obwohl es genaugenommen ein 68020-Befehl ist; beim 
Auftreten eines Bcc.L wird eine Warnung generiert. Ein BRA.S zum darauf¬ 
folgenden Befehl ist nicht erlaubt und wird, mit einer Warnung, in einen NOP 
verwandelt. Ein BSR.S zum darauffolgenden Befehl ist nicht erlaubt und erzeugt 
einen Fehler. 

BTST 

BTST ist einzigartig unter den Bit-Test-Befehlen, weil es PC-relative Adressiermodi 
unterstützt. 

CLR 

CLR An ist nicht erlaubt, benutzen Sie statt dessen SUB.L An,An; die Flags werden 
von diesem Befehl aber nicht beeinflußt. 

CMP 

Wenn der Source-Operand immediate ist, wird CMPI erzeugt, wenn der Ziel- 
Operand ein Adreßregister ist, wird CMPA benutzt. Wenn Sie die Adressierungs¬ 
arten beider Operanden postinkrement benutzen, wird ein CMPM generiert. 

DBcc 

DBRA wird für DBF akzeptiert. 

ILLEGAL 

Das Op-Code-Wort $4AFC wird generiert. 

LINK 

Wenn der Wert positiv oder ungerade ist, wird eine Warnung ausgegeben. 
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MOVE from CCR 

Dies ist ein Befehl der Prozessoren 68010 und höher. Es wird in ein MOVE from 
SR konvertiert. 

MOVEQ 

Wenn der Wert im Bereich 128 bis 255 inklusive ist, wird eine Warnung ausge¬ 
geben. Wenn Sie ausdrücklich ein .L angeben, wird keine Warnung erzeugt. 


3.7 Assembler-Direktiven 

Genim kennt bestimmte Pseudo-Mnemoniks. Diese Assembler-Direktiven, wie sie 
auch genannt werden, werden (normalerweise) nicht in 68000-Code übersetzt, 
sondern veranlassen den Assembler zu bestimmten Aktionen während des 
Assemblerlaufs. Diese Aktionen bewirken z.B. die Änderung des erstellten Objekt- 
Codes oder der Form des Listings. Direktiven werden genauso wie Befehle behan¬ 
delt, können auch Labels haben (einige müssen Labels haben) und können von 
einem Kommentar gefolgt sein. Wenn Sie ein Label vor eine Direktive setzen, bei 
der das nicht unbedingt erforderlich ist, ist deren Wert Undefiniert und wird norma¬ 
lerweise als Label ignoriert. 

Im folgenden werden die Direktiven im einzelnen beschrieben. Bitte beachten Sie, 
daß die Schreibweise (groß/klein) unwichtig ist, im Handbuch wurde Groß¬ 
schreibung verwendet. Spitze Klammem (< >) bezeichnen optionale Parameter, 
Auslassungen (...) zeigen Wiederholungen an. 

3.7.1 Assembler-Kontrolle 

Die folgenden Direktiven beeinflussen den Assemblerlauf: 

END 

END bezeichnet das Textende für den Assembler, alles was danach kommt, wird 
ignoriert. END sollte am besten in der letzten Zeile stehen. 

INCLUDE Dateiname 

Diese mächtige Direktive holt ein Stück Quelltext von der Disk. Er wird genauso 
behandelt, als ob er im RAM stünde. Der Direktive muß ein Dateiname im gültigen 
AmigaDOS-Format folgen. Enthält der Name Leerstellen, muß er in Anführungs- 
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Zeichen oder Hochkommas stehen. Laufwerks- und Directory-Angaben sind mög¬ 
lich, z.B. 

include dfl:constants/header.s 

Include-Direktiven können so tief geschachtelt werden, wie Speicherplatz vor¬ 
handen ist. Tritt ein Fehler beim Öffnen oder Lesen des Files auf, wird mit einer 
Fehlermeldung abgebrochen. 

INCDIR ”Directory” <," Directory” u.s.w> 

Diese Direktive gibt eine Liste von Directories an, in denen (und in dieser Reihen¬ 
folge) Include-Direktiven die Files suchen sollen. Genim setzt dafür die Strings der 
Reihe nach vor die Filenamen der Include-Direktiven. Die INCDIR-Direktive muß 
vor Include-Direktiven im Text stehen. 

INCBIN Dateiname 

Mit dieser Direktive wird eine Datei vollständig in Ihr Programm mit einbezogen. 
Dies ist z.B. nützlich für Grafiken, die mit anderen Programmen erstellt wurden und 
von Ihrem Programm in binärer Form benutzt werden; es entfällt eine Konver¬ 
tierung in DC-Direktiven. 

OPT Option <,Option>... 

OPT erlaubt die Kontrolle diverser Optionen innerhalb von GenAm. Jede davon 
wird mit einem Buchstaben - gefolgt von einem Plus- oder Minuszeichen - 
bezeichnet. Mehrere Optionen können durch Kommas getrennt angegeben werden. 
Die folgenden Optionen (siehe auch OPT) sind erlaubt: 

Option A - Automatische Adressierung im PC-Modus 

Wenn OPT A+ spezifiziert ist, benutzt GenAm dort, wo es möglich ist, PC-Modus- 
Adressierung. Zum Beispiel wird 
MOVE.L intJn.dO 
in 

MOVE.L int_in(pc),d0 

bei der Assemblierung transformiert. 

Der Gebrauch dieser Option kann eine erhebliche Reduzierung der Programmgröße 
und Laufzeit mit sich bringen, ohne daß dafür mehr eingegeben werden muß. 
Beachten Sie aber, daß dadurch nicht garantiert wird, daß positionsunabhängiger 
Code vorliegt. Wenn Sie den automatischen Gebrauch des PC-Modus überspringen 
wollen, sollten Sie den Ausdruck »(Ausdruck).L« ähnlich wie für Kurzworte 
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benutzen. Obiges Beispiel könnte also so manipuliert werden, daß absolute Adres¬ 
sierung verwendet wird: 

MOVE.L(intjn).L.dO 

Wenn keine solchen Transformationen durchgeführt werden, ist der Defaultwert A-. 
Option C - Case-Unterscheidung bei Labels 

Case-Sensitivität bedeutet, daß zwischen Groß- und Kleinbuchstaben unterschieden 
wird. Per Voreinstellung ist GenAm case-sensitiv, dies kann durch C- (nicht case- 
sensitiv) überschrieben oder mit C+ wieder zurückgesetzt werden. Die Signifikanz 
kann durch Angabe einer neuen Spezifikation zwischen dem C und dem jeweiligen 
Zeichen bestimmt werden. So gibt z.B. C16-f eine Signifikanz von 16 Zeichen an. 
Die Direktive muß im Text stehen, bevor irgendein Label eingesetzt oder definiert 
wird. Am sinnvollsten ist sie ganz am Anfang einer Source-Datei. 

Option D - Debugging Information 

Das AmigaDOS-Format für Binär-Files erlaubt es, eine Symboltabelle an das File- 
Ende zu hängen, die von Debuggern wie MonAm gelesen werden kann und beim 
Debuggen sehr nützlich ist. Per Voreinstellung ist diese Option nicht aktiv, kann 
aber mit D+ ein- bzw. mit D- ausgeschaltet werden. Es werden nur relative Labels 
aufgezeichnet, und zwar in Großschrift, wenn GenAm nicht auf case-sensitiv ein¬ 
gestellt ist. Wenn mehr als eine D-Option im Text auftritt, wirkt nur die letzte. 

Option L - Linker Modus 

Normalerweise erstellt GenAm ausführbaren Code, L+ generiert linkbaren Code, 
und L- stellt wieder ausführbaren Code ein. Die Direktive muß in der ersten Zeile 
des Textes stehen (auch keine Leerzeile davor!). Wenn der Linker-Modus aktiv ist, 
sind noch zusätzliche Direktiven möglich (wird an späterer Stelle noch gezeigt). 

Option M - Makro-Expansion 

Wenn ein Assembler-Listing erzeugt wird, werden darin enthaltene Makro-Aufrufe 
in der gleichen Form wie im Quelltext ausgegeben. Wenn Sie eine Auflistung der 
Befehle innerhalb der Makros wünschen, wählen Sie M-f*. M- schaltet diese Option 
wieder aus. Diese Direktive können Sie in einem Text so oft einsetzen wie erfor¬ 
derlich. 

Option N - Narrow (schmales) Listing 

Diese Option ist für Drucker mit nicht mehr als 80 Spalten vorgesehen. Wenn Sie 
mit N+ aktiviert ist, wird ein verkürztes Listing ohne Zeilennummern und ohne 
Objekt-Code erzeugt. Zum Umschalten auf »breit« dient N-. 
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Option O - Optimierung 

GenAm besitzt die Fähigkeit, manche Befehle zu kürzen oder deren Geschwindig¬ 
keit zu erhöhen. Standardmäßig wird zwar keine Optimierung vorgenommen, jedoch 
kann jede Art von Optimierung wahlweise hinzugeschaltet werden. 

01+ Optimiert Rückwärts-Branches wenn möglich, kann mit 01- wieder ab¬ 
geschaltet werden. 

02+ Optimiert Adreßregister indirekt mit Offset in Adreßregister, wenn der Off¬ 
set Null ist; kann mit 02- abgeschaltet werden. 

»move.l Wert(aO),d3« wird zu »move.l (aO),d3« wenn Wert gleich Null. 

0+ schaltet alle Optimierungen ein. 

O- schaltet alle Optimierungen ab. 

OW- schaltet die mit den Optimierungen verbundenen Warnungen aus, sie 
können mit 0W+ wieder eingeschaltet werden. 

Wenn während der Assemblierung eine Optimierung vorgenommen wurde, werden 
die Zahl der Optimierungen und die gespeicherten Bytes am Ende der Assemblie¬ 
rung angezeigt. 

Option P - Prüfung auf positionsunabhängigen Code 

Normalerweise erlaubt GenAm positionsunabhängigen Code. Wenn Sie aber nur 
PC-relativen Code generieren wollen, können Sie die Option P+ als Kontrolle ein- 
setzen. Wenn der Code nicht positionsunabhängig sein sollte, werden Fehler¬ 
meldungen erzeugt. Mit P- wird die Kontrolle wieder ausgeschaltet. Mehrere P- 
Optionen in einem Text sind möglich, um zum Beispiel sicherzustellen, daß ein 
bestimmter Programmteil positionsunabhängig ist. 

Option S - Symboltabelle 

Wenn ein Listing erzeugt wird, gehört dazu eine Symboltabelle am Ende des 
Listings. Wenn Sie diese nicht benötigen, können Sie sie mit S- ausschalten bzw. 
mit S+ wieder einschalten. Gültigkeit besitzt nur die letzte Anweisung . 

Anmerkung des Übersetzers: Die Symboltabelle der Include-Files kann sehr lang 
werden; es ist deshalb ratsam, sie abzuschalten. 

Option T - Typen-Überprüfung 

GenAm kann Programmierfehler entdecken, indem es Ausdrücke dahingehend 
prüft, ob sie absolut oder relativ sind. Da für manche Anwendungen und Program¬ 
mierstile eine solche Meldung hinderlich sein kann, ist die Überprüfung mit T- aus- 
und mit T+ wieder einschaltbar. 
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main bsr init 

lea main(a6),aO 

move.l(main).w,aO 

Diese Zeilen würden normalerweise einen Fehler erzeugen, da »main« ein relativer 
Ausdruck ist und der Assembler in beiden Fällen einen absoluten Ausdruck 
erwartet. Falls aber der Code auf einer anderen 68000-Maschine laufen soll, kann 
dies zulässig sein: T- müßte also angegeben werden. 

Option U - Unterstrich in lokalen Labels 

Mit U+ können Sie angeben, daß lokale Labels mit »_« anstatt mit einem Punkt 
beginnen. Diese Option existiert, um Kompatibilität mit Compilern der Firma 
Prospero zu gewährleisten. 

Option W - Warnungen 

Um die Warnmeldungen von GenAm abzuschalten, geben Sie W- ein, W+ aktiviert 
sie wieder. Diese Direktive kann beliebig oft angewählt werden. 

Option X - Erweiterter Debug 

Dies ist eine erweiterte Version der Option D. Hiermit werden Symbole mit bis zu 
22 Zeichen Länge anstatt maximal 8 Zeichen wie bei D ausgegeben. 


3.7.2 Zusammenfassung der Optionen 

A Automatische PC-Modus-Adressierung 
C+Case-Sensitivität und Signifikanz (CI27+) 

C- Nicht case-sensitiv 

D+Debbuger-Information -> Binär-File 

D- Keine Debbuger-Information -> Binär-File (Voreinstellung) 

L+Erzeugt AmigaDOS-linkbaren Code 

L- Erzeugt ausführbaren Code (Voreinstellung) 

M+ Expandiert Makros im Listing 

M- Keine Makro-Expansion im Listing (Voreinstellung) 

N+Schmales Listing 

N- Breites Listing (Voreinstellung) 

0+Optimierung an 
0- Optimierung aus 

P+ Prüfung auf positionsunabhängigen Code 

P- Prüfung auf positionsabhängigen Code aus (Voreinstellung) 

S+ Symboltabelle mit Listing (durch LIST gesetzt) 

S- Keine Symboltabelle (durch NOLIST gesetzt) 
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T+ Typenüberprüfung an 

T- Typenüberprüfungaus 

W+ Warnmeldungen ausgeben 

W- Warnmeldungen unterdrücken 

X+ Erweiterter Debug 

Zum Beispiel schaltet die Zeile 
opt m+,s+,w- 

die Makro-Expansion im Listing ein, veranlaßt die Ausgabe der Symboltabelle und 
unterdrückt Warnmeldungen. 

<Label> EVEN 

Diese Direktive setzt den Programmzähler auf eine gerade Adresse, d.h., er wird auf 
eine Wortgrenze justiert. Weil GenAm automatisch alle Befehle auf eine Wort¬ 
grenze Justiert (ausgenommen DC.B und DS.B), ist EVEN nicht besonders oft 
erforderlich. Diese Direktive kann aber sehr nützlich sein, wenn man sicherstellen 
will, daß Strings und Puffer auf einer Wortgrenze beginnen. 

CNOP Offset, Justierung 

Diese Direktive justiert den Programmzähler nach dem Offsetwert und der Justie¬ 
rungsart. Eine Justierung von 2 heißt Wortgrenze, eine von 4 Langwortgrenze usw. 
Die Justierung ist relativ zum Programmstart, der immer auf eine Lang wortgrenze 
gesetzt wird. Zum Beispiel: 
cnop 1,4 

justiert den Programmzähler auf die nächste Langwortgrenze plus 1 Byte. Beide 
Parameter müssen numerische, absolute Konstanten sein, Labels sind nicht erlaubt. 
Einige Teile des Amiga-Betriebssystems erfordern Langwortjustierung, was mit 
cnop 0,4 

erreicht werden kann. Bei Programmstart wird immer langwortjustiert. 

<Label> DC.B Ausdruck<,Ausdruck>... 

<Label> DC.W Ausdruck<,Ausdruck>... 

<Label> DC.L Ausdruck<,Ausdruck>... 

Diese Anleitungen definieren Konstanten im Speicher. Sie können einen oder 
mehrere Operanden, getrennt durch Kommas, besitzen. Die Konstanten werden auf 
Wortgrenzen für DC.W und DC.L gesetzt. In einer einzigen DC-Direktive können 
nicht mehr als 128 Byte erzeugt werden. DC.B behandelt Strings etwas anders als 
solche in normalen Ausdrücken. Die Regeln bezüglich der Anführungszeichen 
gelten auch hier, jedoch können Byte nicht gepaddet werden. Die String-Länge kann 
bis zu 128 Byte betragen. 
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Seien Sie vorsichtig mit Leerzeichen in DC-Direktiven, da ein Leerzeichen 
Kommentare einleitet! Die Zeile »dc.b 1,2,3 ,4« erzeugt nur 3 Byte, das vierte wird 
als Kommentar behandelt. 

<Label> DS.B Ausdruck 
<Label> DS.W Ausdruck 
<Label> DS.L Ausdruck 

Diese Direktiven reservieren Speicherplatz, die Inhalte werden auf Null gesetzt. 
Wenn ein Label enthalten ist, wird es auf den Anfang des definierten Bereichs 
gesetzt, der nur eine Wortgrenze für DS.W- und DS.L-Direktiven ist. Zum Beispiel 
reserviert jede der folgenden Zeilen auf verschiedene Weise 8 Byte Speicherplatz: 
ds.b 8 
ds.w 4 
ds.l 2 

<Label> DCB.B Zahl,Wert 
<Label> DCB.W Zahl,Wert 
<Label> DCB.L Zahl,Wert 

Diese Direktive erlaubt, daß aus der spezifizierten Größe konstante Blöcke von 
Daten erzeugt werden. »Zahl« zeigt an, wie oft »Wert« wiederholt werden soll. 

FAIL 

Diese Direktive erzeugt den Fehler »user error«. Sie kann als Warnung für den 
Programmierer verwendet werden, wenn einem Makro eine falsche Anzahl von 
Parametern übergeben wurde. 

OUTPUT Dateiname 

Mit dieser Direktive läßt sich der Name der Ausgabedatei bestimmen. Wenn der 
angegebene Dateiname mit einem Punkt beginnt, wird nur die Extension der 
erzeugten Datei beeinflußt. Der Name wird sonst nach den oben beschriebenen 
Regeln gebildet. 

_G2 (reserviertes Symbol) 

Dieses Symbol kann mit der IFD-Bedingung verwendet werden, um festzustellen, 
ob mit GenAm2 assembliert wird. Der Wert dieses Symbols ist die Version des 
Assemblers und immer absolut. 

Wiederholung von Schleifen 

Manchmal ist es sehr nützlich, wenn eine oder mehrere Anweisungen mehrmals 
wiederholt werden können. Die Repeat-loop-Konstruktion erlaubt das. 
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<LabeI> REPT Ausdruck 
ENDR 

Die zu wiederholenden Zeilen müssen innerhalb von REPT und ENDR stehen, die 
Anzahl der Wiederholungen steht im Ausdruck. Wenn der Ausdruck Null oder 
negativ ist, wird kein Code erzeugt. Wiederholungsschleifen können nicht ver¬ 
schachtelt werden. Ein Beispiel: 

REPT 512/4 Schnelles Kopieren eines Sektors 
move.l (a0)+,(al)+ 

ENDR 

Hinweis: In Wiederholungsschleifen sollten keine Programmlabels definiert 
werden, da sonst die Meldung »label defined twice« erscheint. 

3.7.3 Listing-Kontrolle 

Die folgenden Direktiven kontrollieren die Form des Listings: 

LIST 

Diese Direktive gibt das Listing im Pass 2 aus, und zwar auf das Gerät/File, das 
vorgewählt wurde, oder auf den Bildschirm. Alle folgenden Zeilen werden gelistet, 
bis eine END-Direktive, das Textende oder eine NOLIST-Direktive erreicht ist. Gibt 
es vorher keine NOLIST-Direktive, wird auch die Symboltabelle ausgegeben, es sei 
denn, diese wurde via OPT-S ausgeschaltet. Eine umfassendere Kontrolle über die 
Listing-Sektionen des Programms kann durch den Gebrauch der LIST+- oder 
LIST--Direktive erreicht werden. Ein Zähler bestimmt, ob die Direktive an- oder 
ausgeschaltet ist. LIST-i- addiert I zum Zähler, LIST- subtrahiert I vom Zähler. 
Wenn der Wert des Zählers Null oder positiv ist, ist LIST an-, wenn er negativ ist, 
ist LIST ausgeschaltet. Der Standard-Startwert beträgt -1 (also Listing aus). Beson¬ 
ders über Include-Dateien kann eine beträchtliche Kontrolle ausgeübt werden. Die 
normale LIST-Direktive setzt den Zähler auf 0, NOLIST setzt ihn auf-I. 

NOLIST 

NOLIST schaltet das Listing aus. Tritt danach keine LIST-Direktive mehr auf, wird 
auch keine Symboltabelle ausgegeben, es sei denn, daß dies über OPT-S vorgewählt 
wurde. 

PLEN Ausdruck 

PLEN setzt die Seitenlänge in Zeilen auf den Wert von »Ausdruck«. Voreingestellt 
ist 60, der neue Wert muß zwischen 12 und 255 liegen. 
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LLEN Ausdruck 

LLEN setzt die Zeilenlänge in Zeichen auf den Wert von »Ausdruck«. Voreinge¬ 
stellt ist 132, der neue Wert muß zwischen 38 und 255 liegen. 

TTL String 

TTL druckt den Text-String, der in Hochkommas eingeschlossen sein kann (bei 
Leerstellen), als Titel zu Beginn jeder Seite. Wenn kein Titel spezifiziert wurde, 
wird der aktuelle Include-Dateiname verwendet. 

SUBTTL String 

Setzt den auf Jeder Seite gedruckten Untertitel zum gegebenen »String«, der in 
Hochkommas stehen kann. Die erste Direktive setzt den Untertitel der ersten Seite 
usw. 

SPC Ausdruck 

SPC erzeugt so viele Leerzeilen im Listing, wie in »Ausdruck« angegeben. 

PAGE 

Page bewirkt einen Seitenvorschub im Listing. 

LISTCHAR Ausdruck<,Ausdruck>... 

Dies sendet die angegebene Zeichenfolge an das Listing-Gerät (mit Ausnahme des 
Bildschirms) und dient zum Beispiel zur Druckerumschaltung auf Schmalschrift. 
Wird zum Beispiel auf das Gerät PRT: ausgegeben, wird mit 
listchar 27,'[','4','w' 

der Drucker in den Schmalschrift-Modus gesetzt. Wenn Sie PAR: oder SER: 
benutzen, müssen Sie die druckerspezifischen Codes senden. Zum Beispiel ergibt 15 
den Schmalschrift-Modus auf Epson-Druckem und Kompatiblen. 

FORMAT Parameter<,Parameter> ... 

Durch diese Direktive ist eine exakte Kontrolle über das Format einer Zeile im 
Source-Code möglich. Jeder Parameter kontrolliert ein Feld im Listing und muß aus 
einer Zahl zwischen 0 und 2 bestehen, gefolgt von a-H oder a-: 

0 Zeilennummer, dezimal 

1 Sektionsname/-zahl und Programmzähler 

2 Hexdaten in Worten bis zu 10 Worte, außer, wenn der Drucker breiter als 
80 Zeichen ist. 
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3.7.4 Label-Direktiven 

Die folgenden Direktiven sind zusammen mit Labels anzuwenden. 

Label EQU Ausdruck 

Equate heißt soviel wie Gleichsetzung, in einigen Assemblern wird dafür tatsächlich 
auch das Gleichheitszeichen (=) eingesetzt. Die EQU-Direktive setzt den Wert und 
den Typ von »Label« gleich dem Ergebnis von »Ausdruck«. Dieser darf keine 
Vorwärts-Referenzen und keine externen Labels enthalten. Bei einem Fehler in 
Ausdruck wird kein Wert zugewiesen. Das Label muß vorhanden sein. 

label = Ausdruck 

Die alternative Form des EQU-Ausdrucks. 

Label EQUR Register 

Die EQUR-Direktive erlaubt es, ein Daten- oder Adreßregister mit einem vom 
Anwender vergebenen Namen anzusprechen, der als Label anzugeben ist. Dies 
nennt man Register-Equate. Ein Register-Equate muß vor dem ersten Gebrauch 
definiert werden. 

Label SET Ausdruck 

SET ist EQU ähnlich, allerdings mit dem Unterschied, daß mit SET (immer neuen 
SETs) einem Label andere Werte zugewiesen werden können. Vorwärts-Referenzen 
sind nicht erlaubt. SET ist besonders nützlich für Zähler in Makros, zum Beispiel: 
zcount set zcount+1 

wobei unterstellt wird, daß »zcount« am Anfang des Quelltextes auf 0 gesetzt 
wurde. Zu Beginn von Pass 2 werden alle SET-Labels wieder als Undefiniert initia¬ 
lisiert, so daß ihre Werte in beiden Durchgängen (Pass 1 und Pass 2) dieselben sind. 

Label REG Registerliste 

Mit der REG-Direktive können Sie einem Symbol eine Registerliste zur Ver¬ 
wendung mit MOVEM zuordnen. Somit wird die Gefahr verringert, am Anfang und 
am Ende einer Routine unterschiedliche Registerlisten zu haben. Mit REG definierte 
Symbole können ausschließlich mit MOVEM benutzt werden. 

<Label> RS.B Ausdruck 
<Label> RS.W Ausdruck 
<Label> RS.L Ausdruck 

Mit diesen Direktiven können Sie eine Liste von konstanten Labein erstellen, was 
für Datenstrukturen und globale Variablen sehr nützlich sein kann. Zum näheren 
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Einstieg hier ein paar Beispiele: Nehmen wir an. Sie haben eine Datenstruktur vor 
sich, die aus einem Langwort, einem Byte und einem anderen Langwort besteht. Um 
Ihren Quelltext verständlicher zu machen, könnten Sie folgende Eingaben ver¬ 
wenden: 

rsreset 

d_next rs.l 1 
d_flag rs.b 1 
d_where rs.l 1 

Sie können auf sie dann folgendermaßen zugreifen: 
move.l d_next(aO),al 
move.l d_where(aO),a2 
tst.b d_flag(aO) 

Nehmen wir als weiteres Beispiel an. Sie weisen Ihren Variablen das Offset-Regi¬ 
ster A6 zu (wie in GenAm und MonAm). Sie könnten sie dann folgendermaßen 
definieren: 
onstate rs.b 1 
Start rs.l 1 
end rs.l 1 

Sie können dann auf sie folgendermaßen zugreifen: 
move.b onstate(a6),dl 
move.l start(a6),d0 
cmp.l end(a6),d0 

Jede dieser Direktiven benutzt ihren eigenen Zähler, der bei Beginn jedes Passes auf 
0 steht. Jedesmal, wenn der Assembler auf die Direktive trifft, wird das Label auf 
den aktuellen Wert gesetzt (mit Wortgrenze, wenn es .W oder .L ist). Es wird dann 
gemäß der Größe und Mächtigkeit der Direktive inkrementiert. Wenn obige Defi¬ 
nitionen die ersten RS-Direktiven wären, würde »onstate« auf 0 stehen, »Start« auf 2 
und »end« auf 6. 

RSRESET 

Durch diese Direktive wird der interne Zähler - wie bei der RS-Direktive - zurück¬ 
gesetzt. 

RSSET 

Dadurch kann der Zähler auf einen bestimmten Wert gesetzt werden. 

RS (Reserviertes Symbol) 

Dies ist ein reserviertes Symbol, das den aktuellen Wert des RS-Zählers beinhaltet. 
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3.7.5 Bedingtes Assembiieren 

Bedingtes Assembiieren erlaubt es, ein Programm zu schreiben, das viele interne 
Optionen besitzt, zwischen denen während des Assemblierens ausgewählt werden 
kann. Das kann aus verschiedenen Gründen sehr nützlich sein: 

• Ein Programm soll auf zwei verschiedenen Maschinen laufen. 

• Debug-Code soll nur für die Testversion erzeugt werden. 

• Zwei leicht unterschiedliche Versionen eines Programms werden gebraucht. 

Wir selbst haben all diese Features während der Entwicklung des Devpac gebraucht. 
Der Assembler läuft auf zwei Maschinen, und nur in der hausintemen Version von 
GenAm gibt es Debug-Code. 

Es gibt viele Direktiven, die zum bedingten Assembiieren eingesetzt werden 
können. Die Assemblierungsbedingungen können in Makros durch das Benutzen 
von Argumenten und durch die Definition von Symbolen in EQU- oder SET-Direk- 
tiven festgelegt werden. Zu Beginn eines bedingten Blocks muß eine der vielen IF- 
Direktiven stehen, an seinem Ende ein ENDC. Die bedingten Blöcke können bis zu 
65535 Ebenen tief geschachtelt werden. Labels sollten nicht in den IF- oder ENDC- 
Zeilen stehen, weil diese Direktiven dann vom Assembler ignoriert werden. 


IFEQ Ausdruck 
IFNE Ausdruck 
IFGT Ausdruck 
IFGE Ausdruck 
IFLT Ausdruck 
IFLE Ausdruck 


Diese Direktiven entwickeln den Ausdruck, vergleichen seinen Wert mit 0 und 
schalten in Abhängigkeit vom Ergebnis das bedingte Assembiieren an oder aus. Die 
Bedingungen selbst entsprechen den Bedingungs-Codes des 68000. Wenn zum Bei¬ 
spiel das Label DEBUG den Wert 1 hat, wirken die folgenden Anweisungen 


1 ogon 


1 ogon 


IFEQ DEBUG 

dc.b 'Kommando eingeben: ',0 
ENDC 

IFNE DEBUG 
opt d+ 

dc.b 'Wird's bald?'.0 
ENDC 


so: Die erste Bedingung schaltet das Assembiieren aus, weil 1 nicht gleich (not EQ) 
0 ist , wohingegen die zweite Bedingung das Assembiieren einschaltet, weil 1 nicht 
gleich (NE) 0 ist. Beachten Sie, daß IFNE dem IF in Assemblern entspricht, die nur 
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eine Testbedingung kennen. Die Ausdrücke müssen zu korrekten Werten entwickel¬ 
bar sein. Jeder Fehler hier gilt als fatal und führt zum Abbruch der Assemblierung. 

IFD Label 
IFND Label 

Diese beiden Direktiven erlauben die Kontrolle in Abhängigkeit davon, ob ein Label 
definiert ist oder nicht. Mit IFD wird das Assemblieren eingeschaltet, wenn das 
Label definiert ist, wohingegen es mit IFND eingeschaltet wird, wenn das Label 
nicht definiert ist. Diese Direktiven sollten vorsichtig verwendet werden. Andern¬ 
falls kann unterschiedlicher Code in Paß 1 und Paß 2 erzeugt werden, was zu 
Phasenfehlem führt. 

IFC ’Stringr,’String2’ 

Diese beiden Direktiven vergleichen zwei Strings, die beide in Hochkommas stehen 
müssen. Sind beide gleich, wird das Assemblieren ein-, andernfalls wird es aus¬ 
geschaltet. Der Vergleich findet case-sensitiv statt (Groß-/Kleinbuchstaben werden 
unterschieden). 

IFNC ’Stringr,’String2’ 

Diese Direktive verhält sich ähnlich wie die vorhergehende, abgesehen davon, daß 
das Assemblieren eingeschaltet wird, wenn die Strings nicht gleich sind. Dies sieht 
dem ersten Anschein nach etwas nutzlos aus, aber wenn einer oder beide Parameter 
Makro-Parameter sind, kann dies sehr vorteilhaft sein. 

ELSEIF 

Durch diese Direktive wird das bedingte Assemblieren an- oder ausgeschaltet. 
ENDC 

Diese Direktive beendet die aktuelle Ebene des bedingten Assemblierens. Wenn es 
mehr IF als ENDC gibt, wird eine Fehlermeldung am Ende des Assemblerlaufs aus¬ 
gegeben. 

IIF Ausdruck Anweisung 

Hier liegt ein Kurzausdruck der IFNE-Direktive vor, die die bedingte Assem¬ 
blierung einer einzigen Anweisung oder Direktive erlaubt. ENDC sollte nicht 
zusammen mit IIF-Direktiven verwendet werden. 
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3.8 Makro-Operationen 

GenAm unterstützt voll Makros im Motorola-Format. Das erlaubt zusammen mit 
der bedingten Assemblierung (oder auch allein), daß die Assembler-Program¬ 
mierung wesentlich vereinfacht und die Lesbarkeit des Programms verbessert wird. 
Ein Makro ist ein Hilfsmittel für den Programmierer, der damit ganze Sequenzen 
von Direktiven spezifizieren kann, die sehr oft verwendet werden. Ein Makro wird 
zuerst definiert, damit sein Name in einem Makro-Aufruf, wie z.B einer Direktive 
mit bis zu 36 Parametern, verwendet werden kann. 

Makro-Definitionen werden im Makro-Puffer gespeichert, welcher jeweils der freie 
Bereich am Ende des Textes ist, den Sie editieren. Die Anzahl freier Bytes - 4 in der 
Statuszeile - ist der zur Verfügung stehende Raum. 

Label MACRO 

Dies startet eine Makro-Operation und veranlaßt GenAm, alle folgenden Zeilen in 
den Makro-Puffer zu kopieren, bis ein ENDM auftritt. Makros können verschachtelt 
werden. 

ENDM 

ENDM beendet (nach einer MACRO-Direktive) das Abspeichem einer Makro-Defi¬ 
nition. Ein Label ist in dieser Zeile nicht erlaubt. 

MEXIT 

Dadurch wird eine Makroentwicklung vorzeitig beendet und ist mit dem INC- 
Makro, das noch gezeigt wird, bestens erläutert. 

NARG (reserviertes Symbol) 

NARG ist keine Direktive, sondern ein reserviertes Symbol (eine Assembler- 
Variable). Ihr Wert ist die Anzahl der Parameter, die an das aktuelle Makro über¬ 
geben wurden, oder 0, wenn sich der Assembler nicht innerhalb eines Makros 
befindet. Wenn sich GenAm im case-sensitiven Modus befindet, ist die Schreib¬ 
weise wichtig, NARG muß deshalb komplett in Großbuchstaben geschrieben 
werden. 

Makro-Parameter 

Wenn ein Makro mittels der MACRO-Direktive definiert wurde, kann es aufgerufen 
werden, indem man seinen Namen, gefolgt von bis zu 36 Parametern, als Direktive 
verwendet. Im Makro selbst stehen die Parameter als Backslash-Zeichen (\), gefolgt 
von einer Ziffer von 1 bis 9. Sie werden durch die Jeweiligen Aufrufparameter 
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ersetzt (oder auch nicht, wenn sie fehlen). Der spezielle Parameter \0 bewirkt, daß 
der Typ (B, W, L) beibehalten wird, der dem Makro beim Aufruf eventuell 
angehängt wurde (wird W, wenn der Typ fehlt). Durch die Verwendung der Syntax 
»\<Symbol>« oder »\$<Symbol>« kann ein Symbol in eine hexadezimale oder 
dezimale Abfolge von Zahlen umgesetzt werden. Das Symbol muß zum Zeitpunkt 
der Expansion definiert sein. 

Der Parameter »N@« dient dazu, unterschiedliche Labels bei jedem Makro-Aufruf zu 
erzeugen. »Vg)« wird in der Makro-Entwicklung durch »_nnn« ersetzt, wobei nnn 
eine Zahl ist, die bei jedem Aufruf um 1 erhöht wird. Wenn ein Makro-Parameter 
Leerstellen oder Kommas enthält, sollte er in spitze Klammem (< >) gesetzt 

werden. Per Voreinstellung wird im Assemblerlisting nur der Makro-Aufruf und 
nicht der produzierte Code gezeigt. Jedoch kann mit der schon beschriebenen OPT- 
M-Direktive die Makro-Erweiterung mit Listing an- und abgeschaltet werden. Ein 
echtes »\« muß in einer Makro-Definition durch »W« spezifiziert werden. 

Ein Makro-Aufruf kann über mehr als eine Zeile gehen, was besonders bei Makros 
mit einer langen Liste von Parametern erforderlich ist. Der Makro-Aufmf muß dafür 
mit einem Komma enden, die nächste Zeile muß mit einem von Tabs oder Leer¬ 
zeichen gefolgten »&« beginnen. 

Im Assemblerlisting zeigt der Default-Wert nur den Makro-Aufmf und nicht den 
erzeugten Code. Makro-Expansion-Listings können durch die OPT-M-Direktive an- 
und ausgeschaltet werden. Makro-Aufrufe können so tief geschachtelt werden, wie 
Speicherplatz vorhanden ist, und können auch rekursiv sein. Makro-Namen werden 
in einer separaten Symboltabelle gespeichert, so daß es keine Überschneidungen mit 
ähnlich benannten Routinen geben kann. Sie können mit einem Punkt beginnen. 

Makro-Beispiele 

Beispiel 1: Aufruf des BDOS 

Im allgemeinen werden Amiga-Library-Routinen so aufgerufen: 

Register A6 sichern 
A6 mit dem Library-Zeiger laden 
ein JSR mit Offset(A6) ausführen 
A6 zurückspeichem 

Ein Makro, das die oben genannte Folge abarbeitet, könnte lauten 


calljib MACRO 
move.l 

a6,-(sp) 


move.l 

\2,a6 

Hole Lib-Zeiger 

jsr 

_LV0\l(a6) 

Lib-Routine aufrufen 

move.l 

(sp)+,a6 

A6 zurück 

ENDM 
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Die Direktiven sind nur in Großschrift, um sie hervorzuheben. Diese Schreibweise 
ist nicht zwingend erforderlich. Wenn Sie dieses Makro nutzen wollen, um die 
DOS-Funktion Output aufzurufen, gilt: 
cal IJ i b Output ,_D0SBase 

Wenn das Makro expandiert wird, wird \1 durch Output und \2 durch _DOSBase 
ersetzt. \ 0 - falls im Makro benutzt - würde W sein, da kein Typ im Aufruf 
angegeben wurde. Der oben genannte Aufruf wird assembliert als 


move.l 

a6,-(sp) 


move.l 

\2.a6 

Hole Lib-Zeiger 

jsr 

_LV0\l(a6) 

Lib-Routine aufrufen 

move.l 

(sp)+,a6 

A6 zurück 


Beispiel 2: Ein INC-Befehl 

Der 68000 hat keinen INC-Befehl wie andere Prozessoren, derselbe Effekt kann 
aber auch mit einer ADDQ #1-Anweisung erreicht werden. Folgendes Makro kann 
dazu benutzt werden: 
inc MACRO 
IFC 

fall Fehlender Parameter 

MEXIT 

ENDC 

addq.\0 #1.\1 
ENDM 

Ein Beispiel-Aufruf wäre 
inc.l aO 
dies wird expandiert zu 
addq.l #l,aO 

Das Makro beginnt mit dem Vergleich des ersten Parameters mit einem leeren 
String. Wenn Gleichheit besteht, wird über FAIL eine Fehlermeldung verursacht. 
Die MEXIT-Direktive wird eingesetzt, um das Makro zu verlassen, ohne daß der 
Rest expandiert wird. Wenn kein leerer Parameter existiert, wird die ADDQ-Anwei- 
sung ausgeführt, wobei der Typ des \0-Parameters eingesetzt wird. 

Beispiel 3: Ein Makro zur Lösung von n-Eakultät 

Obwohl man praktisch das Problem nicht so löst, definiert dieses Makro ein Label 
als Fakultät einer Zahl. Dies zeigt aber sehr schön, wie Rekursionen in Makros 
funktionieren können. Bevor das Makro gezeigt wird, ist es nützlich, sich anzu¬ 
sehen, wie die Lösung in einer Hochsprache wie Pascal aussehen würde: 
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function factor(n:integer):integer; 
begin 

if n>0 then 

factor;=n*(factor-l) 

eise 

factor:=l 

end; 


Die Makro-Definition nutzt die SET-Direktive für Multiplikationen wie n*(n-l) 


*(n-2) 

usw. auf diese Art: 


factor 

MACRO 




IFND 

\i 


\1 

set 

1 

setze 1 für ersten Aufruf 


ENDC 




IFGT 

\2 



factor 

\1.\2-1 

nächste Ebenen abarbeiten 

\1 

set 

\1*(\2) 

n=n*(factor-l) 


ENDC 




ENDM 



* Beispielaufruf 




factor 

test,3 



Das Ergebnis ist, daß die Variable »test« auf 3! (Fakultät von 3) gesetzt wird. Der 
Grund dafür, daß beim zweiten SET (\2) anstatt \2 geschrieben wurde, ist, daß dieser 
Parameter normalerweise nicht ein simpler Ausdruck ist, sondern eine Liste von 
Zahlen, die durch Minuszeichen getrennt sind. Das könnte also so assembliert 
werden: 


test set test*5-l-l-l 
(d.h. test*5-3) anstatt des richtigen 
set test*(5-l-l-l) 

(d.h. test*2) 


Beispiel 4: Bedingtes Return 

Der 68000-CPU fehlt das bedingte Return, wie man es bei anderen Prozessoren 
findet. Hier kann jedoch dafür ein Makro definiert werden, das den '^-Parameter 
benutzt. Zum Beispiel könnte ein Makro für »return if EQ« so aussehen: 
rtseq MACRO 

bne.s x\@ 
rts 
x\@ 


ENDM 
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Der'^-Parameter wurde genommen, um unterschiedliche Labels bei jedem Aufruf 
zu generieren. So würden in diesem Fall Labels wie x_002 oder x_017 entstehen. 

Beispiel 5: Numerische Substitution 
vname MACRO 

dc.b \l,\<version>,0 

ENDM 


Version equ 42 

vname <'Buchstabensuchprogramm v'> 

wird expandiert zu: 

dc.b 'Buchstabensuchprogramm v','42',0 


Beispiel 6: Ein komplexer Makro-Aufruf 


Nehmen wir an, daß ein Programm eine komplizierte Tabellenstruktur aufweist, die 
eine variable Anzahl von Feldern beinhaltet. Ein Makro kann z.B. auch dafür 
geschrieben werden, daß angegebene Parameter verwendet werden: 


Tabellen_Eintrag 


ENDC 


.end\@ dc.b 


MACRO 


dc.b 

.end\@-* 

Längenbyte 

dc.b 

\i 

immer 

IFNC 



dc.w 

\2.\3 

2. und 3. 

dc.l 

\4,\5.\6.\7 


IFNC 



dc.b 

ENDC 

'\8' 

text 

dc.b 

0 

ENDM 

\9 



* Beispiel für einen Aufruf 

Tabellen_Eintrag $42,,,tl,t2,t3,t4, 

& <namen Eingeben:>,%0110 

Dieses Beispiel zeigt sehr deutlich, daß Makros die Programmierarbeit enorm 
erleichtern können. In diesem Fall wird mit einer Datenstruktur gearbeitet, die aus 
einem Längenbyte (im Makro mit Hilfe vonN@ errechnet), zwei optionalen Worten, 
vier Langworten, einem optionalen String, einem Byte und einem Null-Byte besteht. 
Der Code, der aus diesen Beispiel resultiert, sieht so aus: 



70 Kapitels 


dc.b 

.end_001 

dc.b 

$42 

dc.l 

tl,t2.t3,t4 

dc.b 

'Namen eingeben: 

dc.b 

%0110 

dc.b 

0 


3.9 Ausgabedatei-Formate 

GenAm kann sowohl ausführbaren als auch linkbaren Code erzeugen. Manche 
Direktiven erfordern verschiedene Aktionen, die abhängig davon sind, welches 
Format der Ausgabedatei gewählt wird. Details darüber, wie jedes Format ver¬ 
wendet wird, werden im folgenden gegeben. 

Ausführbare Dateien 

Diese sind direkt ausführbar, z.B. durch Doppelklicken von der Workbench aus, 
oder durch Eingabe des Namens im CLL Die Datei kann verschiedene Sektionen, 
Relozierinformation und/oder Symbolinformationen enthalten. Diese Dateien besit¬ 
zen normalerweise keine Extension. 

Linkbare Dateien 

Wenn Sie größere Programme oder Module in Assembler-Sprache schreiben, die 
von einer High-Level-Sprache verwendet werden sollen, müssen Sie eine linkbare 
Datei erzeugen. Das AmigaDOS-Linkerformat wird von den meisten High-Level- 
Sprachen für den Amiga unterstützt. Normalerweise besitzen sie die Extension .0 
oder .OBJ. 

3.9.1 Das richtige Format 

Wenn Sie mit einer Hochsprache Zusammenarbeiten, haben Sie meistens keine 
Wahl: Sie müssen das vom Compiler unterstützte Format verwenden. 

Wenn Sie ausschließlich in Assembler schreiben, werden Sie wohl das ausführbare 
Format benutzen: die Assemblierzeit ist gering, Linken fällt weg, und Sie können 
direkt in den Speicher assemblieren, um die Tum-around-Zeiten so klein wie 
möglich zu halten. Wenn Sie ein größeres Programm schreiben, womöglich im 
Team, sollten Sie allerdings linkbaren Code bevorzugen. 
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3.10 Ausgabedatei-Direktiven 

ln diesem Abschnitt werden diejenigen Direktiven beschrieben, deren Wirkung vom 
Ausgabedatei-Format abhängig ist. Das richtige Format kann durch folgende 
Methoden gewählt werden: durch die Eingabe von Kommandozeilen, wenn Genim 
direkt vom CLI aus abläuft, durch Anklicken der entsprechenden Optionen in der 
Assemblieren-Optionen-Dialogbox im Editor oder mit der OPT-L-Direktive am 
Anfang der Quelldatei. 


3.10.1 Sektionen 


SECTION String<,Typ> 

Diese Direktive verursacht einen Wechsel zu der genannten Sektion, der Typ wird 
optional definiert. Ein Programm kann aus mehreren Sektionen bestehen, die im 
endgültigen Programm mit gleichnamigen Sektionen zusammengefügt werden. 
»String« und »Typ« werden als Sektionsname verwendet. Sie können Jeweils bis zu 
32 Zeichen lang sein, dürfen nicht in Klammem stehen und keine Tabs oder Leer¬ 
zeichen enthalten. Die Schreibweise des Namens ist signifikant, ln einem Programm 
können mehrere SECTION-Direktiven stehen. Es gibt folgende Typen: 


CODE 

Codesektion, Public Memory 

CODE.F 

Codesektion, Fast Memory 

CODE_C 

Codesektion, Chip Memory 

DATA 

Datasektion, Public Memory 

DATA_E 

Datasektion, Fast Memory 

DATA_C 

Datasektion, Chip Memory 

BSS 

BSS-Sektion, Public Memory 

BSS_F 

BSS-Sektion, Fast Memory 

BSS_C 

BSS-Sektion, Chip-Memory 


CODE-Sektionen werden für ausführbare Anweisungen gebraucht, DATA-Sek- 
tionen für initialisierte Daten (Konstanten) und BSS für nichtinitialisierte Daten. 
BSS-Sektionen besitzen den Vorteil, daß sie keinen Speicherplatz einnehmen - nur 
die Länge der BSS-Sektion wird gespeichert. Wenn Sie eine Sektion als BSS defi¬ 
nieren, können Sie nur mit der DS-Direktive ausführbaren Code erzeugen - jede 
andere Anweisung würde einen 1/0-Fehler in der Binärdatei erzeugen. 

Hinweis: Verwenden Sie in Versionen des Linkers ALINK vor 2.3 keine Typen, die 
Fast Memory oder Chip Memory erfordern, da es sonst zum Absturz kommt. 
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IDNT String 

Dies setzt den Namen »string« als Modulname ein. Er kann bis 32 Zeichen lang 
sein, sollte keine Tab- und Leerzeichen enthalten und nicht in Anführungszeichen 
geschrieben werden. Nur eine IDNT-Direktive ist pro Modul zulässig. 

3.10.2 Importe und Exporte 

Bei beiden linkbaren Formaten ist es wichtig, Symbole importieren und exportieren 
zu können, was sowohl für relative Symbole wie Programmlabels als auch für 
absolute Symbole wie Konstanten gilt. Das AmigaDOS-Linker-Format macht 
keinen Unterschied zwischen diesen beiden Typen; der Assembler kann jedoch eine 
Typenüberprüfung vornehmen, wenn die Typen beim Import spezifiziert wurden, 
und dadurch Fehler im Programm entdecken, die sonst vielleicht übersehen worden 
wären. 

XDEF Export<,Export>... 

Dadurch werden Labels für den Export in andere Programme oder Module definiert. 
Wenn eines der spezifizierten Labels nicht definiert ist, erscheint eine Fehler¬ 
meldung. Lokale Labels können nicht exportiert werden. 

Ausführbar: Diese Direktive wird ignoriert. 

XREF Import<,Import>... 

XREF.L Import<,Import>... 

Dadurch werden Labels als externe Referenzen definiert, d.h., sie werden erst im 
Linkerlauf von anderen Programmen oder Modulen importiert und sind im 
Assemblerlauf unbekannt. Mit XREF werden relative Labels, d.h. Programm¬ 
adressen, definiert, wohingegen mit XREF.L absolute Labels, d.h. Konstanten, 
definiert werden. 

Ausführbar: Diese Direktive wird ignoriert. 

Importe in Ausdrücken verwenden 

Ausführbar: Es gibt keine Importe! Referenzen zu Labein in anderen Sektionen 
unterliegen den unten beschriebenen Einschränkungen. 

Linkbar: Importe können in Ausdrücken verwendet werden. Jedoch ist nur ein 
Import pro Ausdruck erlaubt. Ein Ausdruck mit einem Import muß die Form Import 
+ Zahl oder Import - Zahl haben. Importe können mit beliebig komplexen Aus¬ 
drücken kombiniert werden, jedoch muß der komplexe Ausdruck vorangestellt 
werden, wie z.B. in 

move.1 3+(l«count+5)+import 
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Ausdruck 

Import 

Intersektion 

Beispiel 

Byte 

J 

N 

move.b #test,d0 

Wort 

J 

J 

move.w test(a3),d0 

Langwort 

J 

J 

move.l test,d0 


COMMENT Kommentar 
Diese Direktive wird ignoriert. 

ORG Ausdruck 

Diese Direktive läßt den Assembler positionsabhängigen Code erzeugen; der PC 
wird auf den angegebenen Ausdruck gesetzt. Normalerweise brauchen AmigaDOS- 
Programme kein ORG, auch wenn sie positionsunabhängig sind. Die ORG-Direk- 
tive erlaubt die Erzeugung von ROM-Code oder Code, der für andere 68000- 
Rechner gedacht ist. Es darf mehr als ein ORG im Programm stehen, es wird aber 
kein »Padding« vorgenommen. 

Ausführbar: Diese Direktive sollte mit höchster Vorsicht gehandhabt werden, da das 
erzeugte Programm wahrscheinlich nicht problemlos ausführbar ist. Am Anfang der 
erzeugten Datei steht zwar der AmigaDOS-Header, jedoch am Ende keine 
Relozierinformation. 

Linkbar: Diese Direktive ist nicht erlaubt. 

OFFSET <Ausdruck> 

Hiermit wird die Code-Generierung in eine besondere, assembler-interne Sektion 
umgeschaltet. Der Ausdruck, der nicht angegeben werden muß, setzt den PC dieser 
Sektion. Es werden keine Daten auf Diskette geschrieben, innerhalb dieser Sektion 
ist nur die DS-Direktive erlaubt. Labels, die innerhalb dieser Sektion definiert 
werden, sind absolut. Um einige Systemvariablen des ST (!) zu definieren, sähe der 
Quelltext so aus: 

OFFSET $400 


etv^timer 

ds.l 

1 

soll $400 betragen 

etv_critic 

ds.l 

1 

404 

etv term 

ds.l 

1 

408 

ext_extra 

ds.l 

5 

40C 

memval id 

ds.l 

1 

420 

memcntlr 

ds.w 

1 

424 
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_LK (reserviertes Symbol) 

Dies ist ein reserviertes Symbol. Es kann dazu benutzt werden, zu erkennen, welche 
Code-Art erzeugt wird. Der Wert dieses Symbols ist immer absolut und kann eine 
der folgenden Größen haben: 

3 linkbar 

4 ausführbar 


3.11 Zusammenfassung der Direktiven 


Assemblerkontrolle 


END 

INCLUDE 

INCDIR 

INCBIN 

OFT 

EVEN 

CNOP 

DC 

DS 

DCB 

FAIL 


Ende Quelltext 
Liest Quelltext von Disk 
Setzt Include-Directory 
Liest Binärdatei von Diskette 
Optionskontrolle 
PC auf gerade Adresse 
Justiert PC 
Definiert Konstanten 
Definiert Leerzeichen 
Definiert Konstantenblock 
Erzwingt Fehlermeldung 


Schleifenwiederholung 

REPT Beginn des zu wiederholenden Blocks 

ENDR Ende des zu wiederholenden Blocks 


Listingkontrolle 


LIST 

NOLIST 

LLEN 

PLEN 

TTL 

SUBTTL 

SPC 

PAGE 

LISTCHAR 

FORMAT 


Listing an 
Listing aus 
Seitenlänge setzen 
Zeilenbreite setzen 
Titel setzen 
Setzt Untertitel 
Leerzeilen ausgeben 
Seitenvorschub 
Kontrollzeichen ausgeben 
Definiert Listingformat 
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Labels 

EQU 

EQUR 

REG 

SET 

RS 

RSRESET 

RSSET 


Wert Label setzen 

Register-Equate 

Definiert Registerliste 

Temporären Wert eines Labels setzen 

Reserviert Speicher 

Reset RS-Zähler 

RS-Zähler setzen 


Bedingtes Assemblieren 

Assembliere, wenn 

IFEQ Null 

IFNE nicht null 

IFD Label definiert 

IFND Label nicht definiert 

IFGT größer als 

IFGE größer oder gleich 

IFLT kleiner als 

IFLE kleiner oder gleich 

IFC Strings gleich 

IFNC Strings nicht gleich 

ELSEIF Auf Assemblierung umschalten 

IIFC Immediate If 

ENDC Ende bedingtes Assemblieren 


Makros 

MACRO Start der Definition 

ENDM Ende der Definition 

MEXT Erzwingt Ende Makroexpansion 


Linkerdirektiven 


IDNT 

SECTION 

XDEF 

XREF 

COMMENT 

ORG 

OFFSET 


Setzt Modulname 
Sektionsname 

Definiert interne Labels als public 
Definiert externe, zu importierende Labels 
Wird z.Zt. ignoriert 
Absolute Code-Erzeugung 
Definiert Offsetliste 
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Reservierte Symbole 


NARG Zahl der Makroparameter 

-G2 Interne Versionsnummer 

-RS RS-Zähler 

-LK Output-Dateityp 


3.12 Der Linker BLink 

Diese Version von BLink ist ein Public-Domain-Linker, der den Standard-Amiga- 
DOS-Linker ALink ersetzen soll. Das Programm besitzt viele Features. Die 
Kommandozeile muß die Form 

blink [FROM] <infilel.o> [<infile2.o>...] [TO <outfile>] 

besitzen, in der ein oder mehrere Inputdateien und eine Outputdatei spezifiziert 
werden. Normalerweise werden Sektionen separat gespeichert, sie können aber 
durch Eingabe von SMALLCODE oder SMALLDATA in der Kommandozeile 
zusammen gespeichert werden. Zum Beispiel wird durch 

blink test.o 

»test.o« in die Datei »test« gelinkt. 

blink FROM Start.o middle. o end.O TO total 

linkt die drei spezifizierten Dateien in »total«. Der komplette Anweisungssatz für 
BLink ist im .doc-File auf Disk 2 enthalten, das entweder am Bildschirm gelesen 
oder durch folgende Methoden ausgedruckt werden kann: 

3.12.1 Maschinen mit einem Laufwerk 

Um die Datei am Bildschirm sehen zu können, geben Sie das Kommando 
type devpacam2:blink.doc 
ein, oder Sie drucken sie mit 
copy devpac2:blink.doc to prt: 

3.12.2 Maschinen mit zwei Laufwerken 

Legen Sie Disk 2 in das externe Laufwerk, und geben Sie entweder 
type dfl:blink.doc 
ein oder 

copy dfl:blink.doc to prt: 
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4.1 Einführung 

Assemblerprogramme sind besonders empfindlich, weil schon der kleinste Fehler 
zum Absturz des Systems führen kann. 

Um Ihnen zu helfen, diese Bugs zu finden und zu korrigieren, enthält das Devpac- 
Amiga-Paket MonAm. MonAm ist ein symbolischer Debugger und Disassembler, 
mit dem Sie Programme im Speicher untersuchen, Programme und einzelne Befehle 
ausführen und durch Programmfehler ausgelöste Exceptions des Prozessors 
abfangen können. Weil MonAm ein symbolischer Debugger ist, können Sie sich Ihr 
komplettes Programm mit allen Labels ansehen. Dadurch wird das Debuggen 
erheblich einfacher, da man nicht mit sechsstelligen Hex-Zahlen kämpfen muß. 

Obwohl MonAm ein sogenannter Low-Level-Debugger ist, der zum Beispiel die 
68000-Befehle oder Bytes im Speicher anzeigt, kann er auch auf Programme 
angewandt werden, die von einer beliebigen Hochsprache kompiliert wurden (und 
Maschinen-Code erzeugt haben). Wenn der Compiler die Option bietet, Symbole in 
das Binär-File zu schreiben, dann werden Sie auch Ihre Prozedur- und Funktions¬ 
namen im Code sehen, natürlich nicht Original-Quelltext. 

Weil MonAm seinen eigenen Bildschirmspeicher benutzt, wird das Display Ihres 
Programms nicht zerstört, wenn Sie es in Einzelschritten abarbeiten oder Break¬ 
points setzen. Das ist besonders bei grafisch orientierten Programmen wie Intuition- 
Anwendungen oder Spielen nützlich. 


4.2 Exceptions des 68000 

MonAm benutzt die 68000-Exceptions, um einen Absturz des zu testenden Pro¬ 
gramms abzufangen, sowie für die Einzelschritt-Abarbeitung Trace-Bits. Deshalb 
erscheint es sinnvoll, zu erläutern, was beim Amiga passiert, wenn Exceptions auf- 
treten. Leider wurde von Commodore etwas Konfusion in die Sache gebracht, indem 
die Exceptions als Traps bezeichnet wurden, was aber in C und Assembler etwas 
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völlig anderes ist. Es gibt viele Arten von möglichen Exceptions. Einige davon sind 
(vom Programmierer) gewollt, andere nicht (Programmierfehler). Im Fall einer 
Exception geht der Prozessor in den Supervisor-Modus, rettet einiges auf dem Stack 
(SSP) und springt zur Exception-Routine. Wenn MonAm aktiv ist, richtet er einige 
Exception-Vektoren auf eigene Routinen, so daß er die Kontrolle übernehmen kann. 
Die verschiedenen Exceptions, ihr normales Ergebnis und das, was passiert, wenn 
MonAm aktiv ist, sind in der folgenden Tabelle dargestellt. 


Exc.-Nr. 

Bezeichung 

Normaler Effekt 

Effekt unter MonAm 

2 

Bus-Fehler 

Guru 

Abgefangen 

3 

Adreß-Fehler 

Guru 

Abgefangen 

4 

Illegaler Befehl 

Guru 

Abgefangen 

5 

0-Division 

Guru 

Abgefangen 

6 

CHK-Befehl 

Guru 

Abgefangen 

7 

TRAPV 

Gum 

Abgefangen 

8 

Privilegverletzung 

Guru 

Abgefangen 

9 

Trace 

Guru 

Einzelschritt 

10 

Line-A-Emulator 

Guru 

Abgefangen 

11 

Line-F-Emulator 

Guru 

Abgefangen 

32-Al 

Trap #0-15 

Guru 

Abgefangen 


Die genauen Gründe für die oben genannte Exceptions (und wie man sie am besten 
behandelt) sind detailliert am Ende dieses Abschnitts beschrieben, kurz sei jedoch 
zusammengefaßt: 

Exceptions 2 bis 8 werden durch einen Programmierfehler verursacht und von 
MonAm abgefangen. Exception 9 kann auf Umwegen durch einen Programmier¬ 
fehler ausgelöst werden. Sie wird von MonAm für die Einzelschritt-Bearbeitung 
benutzt. 

Der Rest (d.h. die Trap-Befehle) sind auf MonAm umgelenkt, können aber nach¬ 
träglich umdefiniert werden, wenn es das Programm erfordert. »Guru« in obiger 
Tabelle bedeutet, daß der Amiga versuchen wird, einen System-Alert-Requester auf 
den Schirm zu zeichnen, der die Exception-Nummer und den PC-Wert zeigt. 
Gelegentlich wird bei schweren Fehlem der ganze Schirm mit buntem Müll gefüllt, 
was zwar sehr beeindruckend aussieht, aber nicht sehr nützlich ist. 
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4.3 Starten von MonAm 

MonAm wird gestartet durch die Eingabe des Kommandos 
monam I Return I 

Dem kann wahlweise ein Programm-Name und eine Kommandozeile (für das Pro¬ 
gramm) folgen. Zum Beispiel: 

monam crgenam examples/demo.s 

startet MonAm, lädt GenAm und übergibt letzterem einen File-Namen. Nachdem 
MonAm geladen wurde, zeigt der Bildschirm vier Fenster, in denen MonAm alle 
Informationen darstellt. Jedes Fenster hat einen speziellen Zweck, doch vorerst ist 
das unterste Fenster das wichtigste. Hier erscheinen alle Tastatureingaben, während 
die anderen Fenster diverse Meldungen ausgeben. Direkt nach dem Laden erscheint 
die Aufforderung »Programmname oder Return eingeben:«. An dieser Stelle müssen 
Sie entscheiden, ob Sie ein Programm debuggen oder sich nur den Speicher ansehen 
wollen. 


4.4 Programm debuggen 

Wenn Sie ein bestimmtes Programm debuggen wollen, sollten Sie den Dateinamen 
einschließlich Laufwerksangabe und Extender eingeben. MonAm wird versuchen, 
die Datei zu laden. Schlägt das fehl, erscheint die Meldung 

AmigaDOS error xx 

Sie können dann einen anderen Dateinamen eingeben oder nur [ Return I . wenn Sie 
Ihre Meinung geändert haben und kein Programm debuggen wollen. Wenn der 
Dateiname gültig ist, lädt ihn MonAm. Nach dem erfolgreichen Laden wird 
»Kommandozeile eingeben:« ausgegeben, und Sie können eine Kommandozeile 
eingeben, die wie üblich (d.h. in die Base Page) übergeben wird. Wenn Sie keine 
Kommandozeile wünschen, geben Sie nur [ Return 1 ein. Nun kommt die Meldung 

Exception: Breakpoint 

und das Haupt-Display erscheint. Der Grund für den Breakpoint ist, daß MonAm 
einen Breakpoint auf den ersten Befehl des Programms setzt und dann dahin springt. 


4.5 MonAm und Multitasking 

Der Amiga ist multitaskingfähig, was für MonAm einige Beschränkungen mit sich 
bringt. Wurde ein Programm (eine Task) geladen, wird er in einen Wartezustand 
versetzt, das heißt in diesem Fall, er wartet auf ein MonAm-Kommando, das ihn 
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weiter ablaufen läßt. Der andere Zustand ist, daß die Task gleichzeitig mit MonAm 
läuft. Einige Kommandos funktionieren nur jeweils in einem dieser beiden 
Zustände. Zum Beispiel können Sie eine Task in Einzelschritten nur in Warte¬ 
zustand abarbeiten. Läuft er, wenn Sie das Kommando (für single Step) eingeben, 
kommt die Fehlermeldung »Unterbrochen!«. 


4.6 Speicher ansehen 

Wenn Sie sich den Speicher ansehen wollen, geben Sie nur I Return I ein, und Sie 
sehen das Haupt-Display und das Prompt-Kommando. 

4.7 Symbolisch debuggen 

Ein Hauptmerkmal von MonAm ist die Fähigkeit, die Originalsymbole des Pro¬ 
gramms beim Debuggen zu benutzen. MonAm unterstützt die Symbol-Hunks, wie 
sie vom Standard-AmigaDOS und von den meisten Amiga-Programmen erzeugt 
werden, die ausführbare Dateien wie Linker, Compiler und Gen Am produzieren. 


4.8 Dialog- und Alarmboxen 

MonAm verwendet viele Dialog- und Alertboxen, die denen von Intuitions-Pro¬ 
grammen entsprechen; es sind aber keine. Der Grund dafür ist einfach: MonAm 
muß vom Betriebssystem so unabhängig wie möglich sein; nur so ist es gewähr¬ 
leistet, daß MonAm auch unter den schwersten Bedingungen problemlos funk¬ 
tioniert. Eine MonAm-Dialogbox erkennt man daran, daß »ESC um abzubrechen« 
über dem linken oberen Rand steht. In der Box steht der Mitteilungstext und 
(normalerweise) eine leere Zeile, in der sich der Cursor befindet. Man kann zu 
jedem Zeitpunkt mit [Esel den Dia log abbrec hen. Die E ingabe erfolgt über die 
Tastatur und die Cursortasten. Die I Backspace I - und I Del I -Taste können zum Edi¬ 
tieren der eingetippten Zeile benutzt werden, S-E löscht die eingetippte Zeile bis 
zum Ende. Die Eingabe wird mit der [ Return I -Taste beendet. Falls eine Zeile einen 
Fehler enthält, wird [ Return I so lange ignoriert, bis die Zeile akzeptabel ist. Dialog¬ 
boxen, in die mehr als eine Zeile eingegeben wird, lassen keine Zeilensprünge durch 
die Cursortasten zu. Eine MonAm-Alarmbox ist eine Box, die eine Meldung 
(meistens eine Fehlermeldung) anzeigt und auf i Return I oder (Esel wartet. 




MonAm, der symbolische Dehugger 81 


4.9 Anfangs-Display 

Sobald Sie im Editor die Dehuggen-O^ixon ausgewählt haben, erscheint eine 
Dialogbox, die Sie um die Eingabe eines Namens bittet. Wenn Sie ein Programm 
von Disk debuggen wollen, geben Sie den Dateinamen und I Return I ein. Sie werden 
dann nach einer Kommandozeile gefragt. Wenn Sie kein Programm debuggen 
wollen, aber zum Beispiel den Speicherplatz ermitteln wollen, drücken Sie I Esc I 
oder geben als Dateiname eine Anzahl Leerzeichen ein. 

4.10 Das Haupt-Display 

Das Haupt-Display von MonAm zeigt Register, einen Speicherbereich und Befehle. 
Das Anzeigenprinzip ist dem von alten Großrechnern nachempfunden: Damals 
befanden sich kleine flackernde Lämpchen an der Vorderseite des Rechners, damit 
man beobachten konnte, welche Register gerade benützt wurden. Dies sind Hard¬ 
ware-Anzeigen, MonAm zeigt Ihnen eine Software-Anzeige - der Code, in dem 
MonAm den Zustand Ihres Computers ausarbeitet und der dann auf dem Bildschirm 
angezeigt wird. 

Die MonAm-Anzeige bei Programmstart besteht aus drei Fenstern: Das obere 
Fenster (Fenster l) zeigt die Daten und Adreßregister an, und den Speicher, auf den 
diese Register zeigen. Das nächste Fenster (Fenster 2) ist das Disassemblierungs¬ 
fenster, in dem mehrere Zeilen disassemblierten Codes zu sehen sind. Die Anfangs¬ 
adresse des Fensters ist normalerweise der PC; A zeigt die momentane Position des 
PC. Fenster 3 zeigt einen Teil des Speichers in Hex und ASCII an. Der Bereich am 
unteren Rand des Bildschirms wird für die Anzeige von Meldungen verwendet. 

Eine der mächtigsten Funktionen von MonAm ist seine Flexibilität in der Fenster¬ 
anzeige - bis zu zwei zusätzliche Fenster können erzeugt, die Fontgröße kann 
verändert, und Fenster können an bestimmte Register gebunden werden. Diese 
Features werden später erläutert. 

4.10.1 Benutzung der Fenster 

MonAm hat immer ein aktuelles Fenster. Dieses Fenster erkennt man daran, daß der 
Fenstertitel weiß auf schwarz, statt umgekehrt, erscheint. Die I Tab I -Taste kann dazu 
verwendet werden, durch die einzelnen Fenster zu gehen, man kann aber auch die 
[Ä]-Taste zusammen mit der Fenstemummer drücken, um ein bestimmtes Fenster 
zum aktuellen Fenster zu machen. Das kleine Fenster unten kann nie das aktuelle 
Fenster werden, da es nur zur Anzeige von Mitteilungen gedacht ist. 
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Hinweis; Falls Ihre Eingaben von MonAm anscheinend ignoriert werden, bedeutet 
das, daß ein anderes Fenster aktiv ist. Um das zu ändern, klicken Sie mit der Maus 
irgendwo in der MonAm-Anzeige. 


4.11 Eingabe von Befehlen 

Der MonAm-Befehlssatz basiert auf einzelnen Tasten, um ein schnelles Arbeiten zu 
ermöglichen. Dies ist zu Anfang natürlich etwas gewöhnungsbedürftig, macht sich 
aber schon nach geringer Zeit bezahlt. Allgemein gilt, daß die S-Taste die 
Fenstertaste ist. Alle Befehle, die die E-Taste beinhalten, haben Auswirkungen auf 
Fenster. 

Befehle können groß oder klein geschrieben eingegeben werden. Alle Befeh le, di e 
unter Umständen katastrophale Auswirkungen haben können, erfordern die I Ctrl l- 
Taste. Befehle werden sofort ausgeführt, es braucht nicht nach jedem Befehl I Return I 
zusätzlich eingegeben zu werden. Ungültige Befehle werden ignoriert. Die Fenster, 
deren Daten sich verändert haben könnten, werden auch nach jedem Befehl auf den 
neuesten Stand gebracht. 

MonAm ist ein sehr funktionsstarkes und manchmal komplex erscheinendes 
Programm. Wir sehen natürlich ein, daß es unwahrscheinlich ist, daß jeder Benutzer 
jeden einzelnen Befehl auf Anhieb gebrauchen wird. Deshalb ist dieses Kapitel in 
zwei weitere Teile gegliedert: einmal eine Einleitung in die Benutzung MonAms 
und darauf folgend ein vollständiger Referenzteil. Es ist ohne weiteres möglich, daß 
Anfänger effektiv den Debugger benutzen, auch wenn sie nur die Bedienungs¬ 
anleitung gelesen haben. Lassen Sie sich aber nicht vom Referenzteil abschrecken: 
Er enthält sehr nützliche und wichtige Informationen. 


4.12 Überblick über MonAm 

Zuerst müssen Sie das Programm laden, das debuggt werden soll. Wenn Sie ein 
Programm in den Speicher assembliert haben, benutzen Sie die Dehuggen-Opixon 
im Editor, ansonsten müssen Sie das Programm von Disk laden. Nachdem Sie den 
Ladebefehl eingegeben haben, werden Sie nach einem Dateinamen gefragt. Wenn 
daraufhin ein Fehler gemeldet wird oder kein Dateiname spezifiziert wurde, können 
Sie durch [ Ctrl l -ITI weitere Namen aufrufen. Vom Debugger werden auch 
Programmsymbole benutzt. Ein Programm enthält Symbole, wenn Sie im 
Assembler oder Linker die Debuggen-Opixon verwenden. 

Eines der wichtigsten Kommandos in MonAm ist das Single-Steppen, das durch 
ICtrl ] -[z] (oder [Ctrl ] -{Y]) aufgerufen werden kann. Dadurch wird die Anweisung 
am PC ausgeführt, der im Registerfenster und normalerweise auch im Disassemblie- 
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rungsfenster gezeigt wird. Nachdem der Befehl ausgeführt wurde, zeigt der 
Debugger nochmals alle Werte der Register an, so daß Sie Schritt für Schritt 
beobachten können, wie Ihr Programm ausgeführt wird. Das Single-Steppen ist die 
beste Methode, sich durch bestimmte Abschnitte des Source-Codes zu bewegen und 
gleichzeitig eine Überprüfung vorzunehmen. Allerdings ist diese Methode die lang¬ 
samste - bis Sie zu der Stelle kommen, die Ihnen vielleicht verdächtig erscheint, 
benötigen Sie viel Zeit und Geduld, da das gesamte Programm single-gesteppt 
werden muß. Jedoch gibt es auch für dieses Problem eine Lösung. 

Ein Breakpoint ist ein spezielles Wort, das in das Programm eingebunden wird, um 
dessen Ablauf zu beenden und MonAm aufzurufen. Es gibt eine ganze Menge von 
verschiedenen Breakpoints, wir werden uns aber in unseren Ausführungen auf den 
einfachsten Typ beschränken. Ein Breakpoint kann durch die Eingabe von (T|-[|] 
mit einer danach folgenden Angabe seiner Adresse gesetzt werden. Sie können in 
MonAm Adressen in Hex (der Grundeinstellung) als Symbol oder als komplexen 
Ausdruck eingeben. Beispiele für korrekte Adressen sind »1A2B0, prog_start, 
lO+mydata«. Bei der Eingabe einer falschen Adresse flackert der Bildschirm, 
worauf Sie eine Korrektur vornehmen können. 

Nachdem Sie einen Breakpoint gesetzt haben, müssen Sie Ihr Programm ablaufen 
lassen. Dies erreichen Sie mit [Ctrl l -ITI. Ihr Programm läuft dann mit Beginn am PC 
ab unter Verwendung der angezeigten Register. MonAm wird wieder aufgerufen, 
wenn ein Breakpoint angetroffen wurde oder eine Exception geschieht. 

MonAm benutzt seine eigene Bildschirmanzeige, die unabhängig ist von Ihren Pro¬ 
grammen. Wenn Sie die Gadgets am oberen Rand des Bildschirms benutzen, sehen 
Sie die aktuelle Programmanzeige. Damit können Sie Programme debuggen, ohne 
deren Output zu zerstören. 

Die Fenster von MonAm können mittels Eingabe von (Ä]-[z] auf volle Bildschirm¬ 
größe gezoo mt w erden. Um in den Hauptbildschirm zurückzukehren, drücken Sie 
[Ä]-CI] oder [Esc] . Durch [Esc] kommen Sie aus fast allen Situationen wieder heraus, 
in die Sie durch Zufall hineingeraten sind. Das Zoom-Kommando arbeitet wie alle 
S-Kommandos auf dem aktuellen Bildschirm, den Sie durch die I Tab ] -Taste ver¬ 
ändern können. Durch Eingabe von |T]-|T] können Sie den Inhalt des aktuellen 
Fensters zum Drucker senden. 

Zum Ändern der Adresse, von der aus ein Fenster seine Daten anzeigt, geben Sie 
E-IÄ] ein und ändern dann die Adresse um. Beachten Sie, daß das Disassemblie¬ 
rungsfenster am PC festgemacht ist und deshalb nach dem Single-Steppen immer 
vom PC aus angezeigt wird. 
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Um MonAm zu verlassen, geben Sie [ Ctrl l -f^ ein. MonAm kehrt daraufhin direkt 
zum CLI zurück. Falls Sie versuchen sollten, das Programm zu verlassen, wenn 
gleichzeitig noch ein Debug ausgeführt wird, werden Sie gewarnt. Wenn MonAm 
während eines Debugs aussteigt und danach Exceptions au ftreten , stürzt die 
Maschine unweigerlich ab. Benutzen Sie vorher also lieber 1 Ctrl l -röl. um die 
Debug-Anweisung zu beenden. Wenn Sie die Debuggen-Opixon vom Editor aus 
benutzen, werden durch [ Ctrl l - fcl sowohl MonAm als auch Ihr Programm beendet. 

Wir hoffen, daß Ihnen dieser Abschnitt einen Überblick über die wichtigsten Eigen¬ 
schaften von MonAm gewährt hat, so daß Sie den folgenden Kapiteln, in denen Sie 
in den Prozeß der Erstellung und des Debuggens von Assemblerprogrammen ein¬ 
geweiht werden, ohne Schwierigkeiten folgen können. 


4.13 MonAm - Referenzteil 

4.13.1 Numerische Ausdrücke 

MonAm kann numerische Ausdrücke auswerten, ähnlich wie in GenAm. Der Haupt¬ 
unterschied zu GenAm liegt darin, daß MonAms normale Zahlenbasis Hex-Code ist, 
dezimalen Zahlen muß ein »\«-Zeichen (kein »#« wie in Version 1!) vorangesetzt 
werden. Es gibt keine Ausdruckstypen (absolut oder relativ), das »*«-Zeichen wird 
nur für die Multiplikation verwendet. Es gibt kein Gleichheitszeichen »<>«. 

Es können Symbole verwendet werden, die normalerweise case-sensitiv sind, d.h., 
daß ein Unterschied zwischen kleinen und großen Buchstaben gemacht wird, und 
die eine Signifikanz bis 32 Zeichen haben (je nach Symbolformat). Diese Standard¬ 
einstellungen können mit Voreinstellungen verändert werden. Register werden mit 
ihren Namen bezeichnet, z.B. A3 oder D7. Dies sind aber keine Hex-Zahlen. Um die 
Hex-Zahl AO anzugeben, muß entweder ein »$«-Zeichen der Zahl vorangesetzt 
werden oder die Zahl Null. A7 bezeichnet immer den User-Stack-Pointer. 

Es gibt reservierte Symbole, die nicht case-sensitiv sind: CODE, SP, SR und SSP. 
CODE bezeichnet das erste Hunk im Programm, nämlich HUNKl. Das zweite Hunk 
ist HUNK2 usw. Es gibt 10 Speicher, MO bis M9, ähnlich wie bei Taschenrechnern. 
Diese Speicher können, wie Register, Werte zugewiesen bekommen. Die Speicher 2 
bis 5 enthalten immer die Startadresse der Fenster 2 bis 5; wenn Sie einem dieser 
Speicher einen neuen Wert zuweisen, verändert sich auch die Anfangsadresse dieses 
Fensters. 

Vorsicht: Weisen Sie nie M4 einen neuen Wert zu, wenn Fenster 4 als Source- 
Fenster benutzt wird. 
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Ausdrücke können auch Indirektionen beinhalten: die Zeichen »{« und »}« werden 
dafür benutzt. Indirektion kann auf einer Byte-, Wort- oder Langwortbasis ange¬ 
geben werden, wenn »}« von einem Punkt und der gewünschten Größe gefolgt wird; 
der Normalwert ist das Langwort. Falls der Pointer ungültig ist, entweder weil der 
Speicher unlesbar oder ungerade ist (wenn Wort- oder Langwortgröße angegeben 
ist), ist der gesamte Ausdruck ungültig. Zum Beispiel gibt der Ausdruck 

{data_start+10}.w 

die Wortinhalte an der Adresse »data_stait-i-10« an, vorausgesetzt, »data_start« ist 
eine gerade Adresse. Indirektionen werden ähnlich verschachtelt. 

4.13.2 Fenstertypen 

Es gibt vier verschiedene Fenstertypen. Die erlaubten Fenstertypen sind wie folgt: 


Fensternummer 

Erlaubte Typen 

1 

Register-Fenster 

2 

Disassemblierungs-Fenster 

3 

Speicher-Fenster 

4 

Disassemblierung, Speicher oder Source-Code 

5 

Speicher 


Register-Fenster-Anzeige 

In einem Register-Fenster werden die Inhalte der Datenregister in Hex angezeigt, 
zusätzlich der ASCII-Wert des untersten Bytes und die Anzeige (in Hex) der ersten 
8 Byte, auf die der Registerinhalt zeigt. Die Adreßregister werden auch in Hex 
angezeigt, zusammen mit den ersten 12 Byte, auf die das Register zeigt. Wie in allen 
Hex-Anzeigen in MonAm werden Werte in nicht lesbaren Speicherstellen mit »**« 
ersetzt. 

Das Statusregister wird sowohl in Hex wie auch als Flags dargestellt. Zusätzlich 
wird entweder »U« oder »S« angezeigt, je nachdem, ob der Rechner sich im Super¬ 
visor- oder Useimodus befindet. »Al« ist der Supervisor-Stack-Pointer und wird 
wie ein normales Adreßregister angezeigt. Der Wert des PC wird zusammen mit der 
Instruktion, die am PC ist, in der untersten Zeile des Register-Fensters angezeigt. 
Wenn die Instruktion ein oder zwei effektive Adressen hat, werden diese zusammen 
mit dem Speicher, der auf diese Adresse zeigt, angezeigt. Zum Beispiel bedeutet die 
Zeile 




86 Kapitel 4 


TST.W $12A(A3) ;00001FAE OFOl 

daß der Wert von »A3« mit »$12A« addiert die Adresse »$1FAE« ergibt. An dieser 
Adresse ist der Wert »$0F01«. Ein komplexeres Beispiel ist 
MOVE.W $12A(A3).-(SP) ;00001FAE OFOl 0002AC08 FFFF 

Der Ursprungs-Adreßmodus ist der gleiche wie im ersten Beispiel, die Zieladresse 
ist dagegen »$2AC08«, die z. Zt. »$FFFF« enthält. Beachten Sie, daß die Anzeige 
immer so groß ist wie gerade nötig. MOVEM-Daten werden als Quad-Worte 
(64 Bit) angezeigt. Wenn Prädekrement im Adressierungsmodus verwendet wird, 
wird dies bei der Adreßberechnung mit in Betracht gezogen. 

In niedriger Auflösung werden keine Hex-Daten für die Datenregister und nur vier 
Byte als Daten bei Adreßregistern angezeigt. Es kann auch in niedriger Auflösung 
Vorkommen, daß die Bildschirmbreite nicht dafür ausreicht, um eine komplexe Zeile 
(wie das zweite Beispiel) anzuzeigen. 

Disassemblierungs-Fenster 

ln einem Disassemblierungs-Fenster wird Speicherinhalt in disassemblierter Form 
angezeigt. Ganz links auf einer Zeile wird die Adresse angezeigt, dann gegebenen¬ 
falls das Symbol an dieser Adresse, daraufhin der Befehl an dieser Adresse. Der 
aktuelle Wert des PC wird mit »>« angezeigt. Falls an dieser Adresse ein Breakpoint 
gesetzt ist, wird dessen Typ in eckigen Klammem ([ ]) nach dem Befehl angezeigt. 
Bei Stop-Breakpoints wird angezeigt, wie oft dieser Befehl noch ausgeführt werden 
muß, bis der Breakpoint aktiv wird und das Programm stoppt. Bei einem Breakpoint 
mit einer Bedingung enthalten die eckigen Klammem ein Fragezeichen, gefolgt von 
der Bedingung. Bei Zähler-Breakpoints enthalten die Klammem ein Gleichheits¬ 
zeichen und den Zählerwert. Bei permanenten Breakpoints ist ein »*« in den 
eckigen Klammem. 

Das Format der disassemblierten Instruktionen ist im Motorola-Standard, wie 
GenAm ihn akzeptiert. Alle Textdaten sind groß geschrieben, bis auf die Symbole, 
die kleine Buchstaben enthalten. Alle numerischen Daten sind in Hex, bis auf die 
TRAP-Nummem. Vorangehende Nullen und der Hex-Bezeichner »$« werden bei 
Zahlen kleiner als 10 nicht angezeigt. Wenn erforderlich, werden numerische Daten 
mit Vorzeichen angezeigt. Die einzige Abweichung vom Motorola-Standard ist die 
Darstellung der Registerliste des MOVEM-Befehls: 

MOVEM.L d0-d3/a0-a2,-(sp) 
wird, um Platz zu sparen, als 
MOVEM.L d0-3/a0-2.-(sp) 
disassembliert. 
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In niedriger Auflösung ersetzen Symbole die Adresse und werden nur bis zu einer 
maximalen Länge von acht Zeichen angezeigt. Gewisse Library-Aufrufe werden 
symbolisch angezeigt, wenn zusammen mit dem Programm keine Symbolinfor¬ 
mation geladen wurde. Der Disassembler ist intelligent und erkennt einen MOVE in 
das Register A6, das von einem JSR gefolgt wird, das A6 gebraucht. Nach dem 
Erkennen wird der Aufruf namentlich angezeigt, wie z.B. in 
MOVE.L 4,A6 

JSR _LV00penLibrary(A6) 

Dies geschieht in den Exec-, Grafik- und Intuition-Libraries, die die spezielle Datei 
»libsdibfile.monam« benutzen. Wenn eine solche Datei während der Initialisierung 
von MonAm nicht gefunden wird, wird eine Disassemblierung nicht ausgeführt. 

Speicher-Fenster 

In einem Speicher-Fenster wird Speicher zeilenweise im Format Hex-Adresse, Hex- 
Daten und ASCII-Daten angezeigt. Unlesbarer Speicher wird als »**« dargestellt. 
Die Anzahl der angezeigten Bytes pro Zeile hängt von der Breite des Fensters ab 
und kann maximal 16 Byte betragen. 

Source-Fenster 

Sie können im Source-Fenster ASCll-Dateien, wie z.B. Ihren Programm-Quelltext, 
ähnlich wie in einem Text-Editor darstellen. Der normale Tab-Abstand ist 8, kann 
aber mit dem Editieren-Fenster-Befehl auf 4 umgeschaltet werden. 

4.13.3 Fenster-Befehle 

Die (T|-Taste ist die sogenannte Fenster-Taste, d.h., alle Fenster-Befehle beinhalten 
die [Äl-Taste. Jeder dieser Befehle bezieht sich auf das aktuelle Fenster, also auf das 
Fenster, dessen Titel invers dargestellt ist. Das aktuelle Fenster kann gewählt 
werden, indem man entweder die I Tab ] -Taste so oft drückt, bis das gewünschte 
Fenster zum aktuellen Fenster wird, oder man drückt S zusammen mit der 
Nummer des gewünschten Fensters. Die meisten Fenster-Befehle funktionieren in 
allen Fenstern, unabhängig davon, ob sie sich im Zoom-Modus befinden oder nicht. 
Wenn ein Befehl keinen Sinn ergibt, wird er ignoriert. 

H-S Adresse setzen 

Dieser Befehl setzt die Anfangsadresse eines Fensters. 
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E-® Breakpoint setzen 

Mit diesem Befehl werden Breakpoints gesetzt; Breakpoints werden später genauer 
beschrieben. 

S-® Editieren 

In einem Speicher-Fenster kann man mit diesem Befehl im Speicher in Hex und 
ASCII editieren. Hex-Zahlen können mit den Tasten 1-9 und A-F eingegeben 
werden. Die Curso rtaste n können dazu benutzt werden, den Cursor im Fenster zu 
bewegen. Mit der HäFI-Taste können Sie zwischen dem Hex- und dem ASCII- 
Editiermodus hin- und herschalten. Der ASCII-Modus schreibt den ASCII-Wert des 
Taste ndruckes in den Speicher. Um den Editiermodus zu verlassen, drücken Sie die 
I Esc I -Taste. 

Im Register-Fenster bewirkt E-® das gleiche wie E-®, nämlich das Setzen von 
Registern. Im Source-Fenster kann mit E-® der Tab-Abstand zwischen 4 und 8 
gewählt werden. 

S-E Fenster binden 

Mit diesem Befehl kann ein Fenster an ein Register oder an ein anderes Fenster 
gebunden werden. Nach einer Exception werden die Startadressen aller Fenster neu 
berechnet und ggf. entsprechend verändert. Um eine Bindung zu löschen, geben Sie 
in die Dialogbox einen Leerstring ein. Fenster 2 ist standardmäßig an den PC 
gebunden. Um ein Fenster an ein anderes zu binden, müssen Sie den entsprechenden 
Speicher angeben, z.B. M2 für Fenster 2. 

E-E Auswerten 

Eine Dialogbox erscheint, in der Sie einen Ausdruck eingeben. Dieser wird aus¬ 
gewertet und in Hex, Dezimal und ggf. als Symbol ausgegeben. 

E-B Drucker-Dump 

Der Inhal t des aktuellen Fensters wird auf dem Drucker ausgegeben. Dieser Befehl 
kann mit I Esc 1 abgebrochen werden. 

E-B Register setzen 

Mit diesem Befehl kann jedes Register gesetzt werden. Das Register muß angegeben 
werden, gefolgt von einem Gleichheitszeichen und dem Ausdruck des neuen 
Registerwerts. Zum Beispiel setzt 
A3=A2+4 

das Register »A3« auf den Wert von Register »A2« mit 4 addiert. Sie können z.B. 
im Zoom-Modus diesen Befehl dazu verwenden, einem anderen Fenster eine neue 
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Startadresse zu geben. Wenn Sie den Zoom-Modus verlassen, zeigt das Fenster auf 
die angegebene Adresse. 

S-d] Fenster spalten 

Dieser Befehl spaltet Fenster 2 in die Fenster 2 und 4 oder das Fenster 3 in die 
Fenster 3 und 5. Jedes neue Fenster ist vom Ursprungsfenster unabhängig. Wenn Sie 
[Ä]-[^ ein zweites Mal drücken, werden die zwei Fenster wieder zusammengefügt. 
Dieser Befehl wird in niedriger Auflösung ignoriert. 

fÄl-fYI Typ verändern 

Dieser Befehl hat nur Wirkung in Fenster 4, das durch die Spaltung von Fenster 2 
entsteht, oder wenn Sie eine ASClI-Datei laden. Der Fenstertyp wird zwischen 
Disassemblierung, Speicheranzeige oder Source umgeschaltet. 

[Ä]-® Zoom 

Das aktuelle Fenster wird mit diesem Befehl auf die volle Bildschirmgröße 
gebracht. Mit I Esc I oder einem erneuten S-E wird das Fenster wieder auf 
Normalgröße gebracht. S-Befehle sind im Zoom-Modus weiterhin benutzbar. 

Cursortasten 

Die Cursortasten werden in Verbindung mit dem aktuellen Fenster benutzt. Ihre 
Wirkung hängt vom Fenstertyp ab. In einem Speicher-Fenster verändern alle vier 
Cursortasten die Startadresse des Fensters. Mit I Shift | - [T] und E können Sie 
seitenweise nach oben und nach unten blättern. In einem Disassemblierungs-Fenster 
verändern [t] und E die Startadresse um jeweils eine Instruktion. E und E 
ändern die Adresse auf Wortbasis. Im Source-Fenster verändern E und E die 
Anzeigen zeilenweise, [ Shift l - E und E seitenweise. 


4.13.4 Bildschirmumschaltung 

MonAm benutzt seinen eigenen Bildschirmspeicher und seinen eigenen Bild¬ 
schirmtreiber, um jeden Konflikt mit dem zu debuggenden Programm zu vermeiden. 
Um ein Flackern des Bildschirms beim Single-Steppen zu verhindern, wird von der 
Bildschirmanzeige auf die des Programms erst nach 20 ms umgeschaltet. Es ist auch 
möglich, den Debugger in einer anderen Auflösung als der für das zu debuggende 
Programm zu betreiben; dies geht aber nur mit einem Farbmonitor. Um den Pro¬ 
gramm-Output betrachten zu können, benutzen Sie die Fenster-Gadgets Ihres 
Amiga. Wenn das Programm auf dem Workbench-Bildschirm abläuft, können Sie es 
durch die linke B-B anzeigen lassen, mit linker B-B kehren Sie in das MonAm- 
Fenster zurück. 
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4.13.5 Breakpoints 

Breakpoints erlauben Ihnen, das Programm an von Ihnen bestimmten Punkten zu 
unterbrechen. MonAm erlaubt maximal acht gleichzeitig gesetzte Breakpoints, von 
denen jeder einer der fünf Breakpoint-Typen sein kann. Wenn ein Breakpoint 
erreicht wird, trifft MonAm die Entscheidung, ob das Programm angehalten wird 
oder weiterläuft. Diese Entscheidung hängt von den Typen des Breakpoints ab. 

Einfache Breakpoints 

MonAm hält das Programm bei Erreichen der Breakpoints an und löscht dann den 
Breakpoint. 

Stop-Breakpoints 

Diese Art unterbricht das Programm an der Stelle, an der ein bestimmter Befehl an 
der Adresse des Breakpoints zum n-ten Mal ausgeführt wurde. Ein einfacher Break¬ 
point ist im Grunde genommen ein Stopp-Breakpoint mit dem Wert 1. 

Zähler-Breakpoints 

Diese Art ist nur ein Zähler. Jedesmal, wenn der Befehl an der Adresse des Break¬ 
points ausgeführt wird, erhöht sich der Zähler um 1, und das Programm läuft weiter. 

Permanente Breakpoints 

Dieser Typ ist den einfachen Breakpoints ähnlich, bis auf den Unterschied, daß sie 
nie gelöscht werden. Jedesmal, wenn dieser Breakpoint erreicht wird, übernimmt 
MonAm die Kontrolle. 

Bedingte Breakpoints 

Diese Art von Breakpoint erlaubt es Ihnen, Ihr Programm nur dann anzuhalten, 
wenn eine bestimmte Bedingung erfüllt ist. Jeder bedingte Breakpoint hat einen 
Ausdruck; dieser wird jedesmal, wenn der Breakpoint erreicht wird, ausgewertet. 
Wenn der Ausdruck wahr (d.h. ungleich Null) ist, wird der Programmablauf unter¬ 
brochen. 

[Ä]-® Breakpoint setzen 

Dies ist ein Fenster-Befehl; er erlaubt das Setzen oder Löschen von Breakpoints zu 
jeder Zeit. Die eingegebene Zeile muß je nach Breakpoint-Typ eines der folgenden 
Formate haben: 
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<Adresse> 

setzt einen einfachen Breakpoint. 

<Adresse>,<Ausdruck> 

setzt einen Stopp-Breakpoint an der angegebenen Adresse, der das Programm 
stoppt, nachdem <Ausdruck> eine bestimmte Anzahl Mal ausgeführt wurde. 
<Adresse>,= 

setzt einen Zähler-Breakpoint. Der Anfangswert des Zählers ist Null. 

<Adresse>,* 

setzt einen permanenten Breakpoint. 

<Adresse>,?<Ausdruck> 

setzt einen bedingten Breakpoint, der von <Ausdruck> abhängig ist. 

<Adresse>,- 

löscht jede Art von Breakpoint an der angegebenen Adresse. 

Breakpoints können nicht an ungeraden und unlesbaren Adressen und im ROM 
gesetzt werden. ROM-Breakpoints können emuliert werden, indem man den Run- 
Until-Befehl benutzt. Jedesmal, wenn ein Breakpoint erreicht wird, egal, ob das 
Programm angehalten wird oder nicht, wird der Prozessorstatus im History-Buffer, 
der später beschrieben wird, behalten. 

Help Breakpoint- und Segmentanzeige 

Dieser Befehl zeigt die Adressen der Text-, Daten- und BSS-Segmente und deren 
Längen zusammen mit sämtlichen gesetzten Breakpoints an. H-Befehle können 
hier auch benutzt werden. 

I Ctrl l -fBl Breakpoint setzen 

Dieser Befehl ist hauptsächlich aus Kompatibilitätsgründen zu MonAm 1 noch vor¬ 
handen. Hiermit wird ein einfacher Breakpoint an der Startadresse des aktuellen 
Fensters gesetzt. Falls schon ein Breakpoint an dieser Adresse vorhanden ist, egal 
welcher Art, wird er gelöscht. 

[ü] Go Until 

Dieser Befehl fragt in einer Dialogbox nach einer Adresse, an der dann ein einfacher 
Breakpoint gesetzt wird. Das Programm läuft danach sofort weiter ab. 

I Ctrl I -Hri Kill Breakpoints 

Alle gesetzten Breakpoints werden gelöscht. 
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[Ctrl ] -(n Breakpoint setzen und ausführen 

Mit diesem Befehl wird ein einfacher Breakpoint nach dem Befehl am PC gesetzt, 
das Programm läuft weiter. Dieser Befehl ist hauptsächlich für DBF-Schleifen 
gedacht, die man nicht immer wieder durcharbeiten will, weil man das Ergebnis 
gleich sehen möchte. 

[Ctrl ) -(n Abbruch der Programmausführung 

Mit diesem Kommando wird der Ablauf Ihres Programms abgebrochen. Da das 
Trace-Bit gesetzt wird, erhalten Sie eine Trace-Exception. Beachten Sie bitte, daß 
Sie das Programm nicht während bestimmter AmigaDOS-Routinen unterbrechen. 
Hinweis: Die im obigen Befehl beanspruchten Speicherfelder sind nicht unbedingt 
in jeder Version des Amiga-Betriebssystems die gleichen. Sie sollten deshalb vorher 
eine Kompatibilitätsprüfung vornehmen. 

4.13.6 History 

MonAm hat einen sogenannten History-Speicher, in dem der Prozessorstatus nach 
jeder Exception behalten wird. Die häufigste Ursache eines Eintrags in den History- 
Speicher ist das Single-Steppen. Aber auch bei jedem Breakpoint und bei bestimm¬ 
ten Arten des Ausführen-Btfthh wird ein neuer Eintrag in den Speicher gemacht. 
Der Speicher enhält Platz für fünf Einträge. Wenn er voll ist, wird jeweils der älteste 
Eintrag gelöscht, damit ein neuer aufgenommen werden kann. 

Ij] History-Speicher-Anzeige 

Ein Fenster wird geöffnet, in dem die maximal fünf Einträge im History-Speicher 
angezeigt werden. Sowohl alle Registerwerte als auch der nächste Befehl, der aus¬ 
geführt wird, werden angezeigt. Wenn auf einen Befehl im History-Speicher ein 
Breakpoint gesetzt ist, zeigt der Wert in den eckigen Klammem den Wert des 
Breakpoints zur Zeit der Anzeige und nicht zum Zeitpunkt des Eintrags in den 
Speicher. 

4.13.7 MonAm verlassen 

[Ctrl l -fcl Abbruch 

Dieser Befehl verursacht einen Programmende-Trap für den aktuellen GEM-DOS- 
Task . Wen n ein Programm mit MonAm debuggt wird, wird zuerst das Programm 
mit [Ctrl i -fcl abgebrochen, und die Meldung »Programmende« erscheint am 
unteren Bildschirmrand im Mitteilungsfenster; durch nochmaliges [ Ctrl l -fcl wird 
MonAm verlassen. Sie können aber auch ein anderes Programm laden, ohne 
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MonAm verlassen zu müssen. Wenn MonAm vom Editor aus aufgerufen wurde, 
kehren Sie sofort nach Beendigung des Programms in den Editor zurück, ohne daß 
Sie I Ctrl l -fcl für MonAm drücken müssen. 

Vorsicht: Es kann durchaus zum Absturz kommen, wenn Sie frühzeitig ein GEM- 
Programm abbrechen, ohne daß z.B. die Virtual Workstation geschlossen wurde. 

(Ctrl l -fol Programm verlassen 

Mit diesem Kommando können Sie das zu debuggende Programm verlassen. Aller¬ 
dings sollten Sie bedenken, daß ein eventuell angegebener Speicherplatz nicht 
deallokiert wird, wenn Sie auf diese Weise aussteigen. Das oben angegebene 
Kommando beansprucht Speicherfelder, die nicht unbedingt bei jeder AmigaDOS- 
Version identisch sind. Sie sollten also zuerst vorsichtshalber einen Probedurchlauf 
machen, bevor Sie sich an eine ernsthafte Anwendung wagen. 

4.13.8 Laden und Abspeichern 

I Ctrl l -in Ausführbares Programm laden 

Mit diesem Befehl wird ein Programm zum Debuggen geladen. Sie werden nach 
dem Programmnamen (wenn nicht anders angegeben, wird .PRG als Extension 
angenommen) und dann nach der Kommandozeile gefragt, die dem Programm über¬ 
geben werden soll. Wenn MonAm schon ein Programm geladen hat, muß dieses 
Programm erst beendet werden, bevor ein neues geladen werden kann. Die Datei, 
die geladen werden soll, muß ein ausführbares Programm sein. Wenn Sie andere 
Dateitypen editieren wollen, müssen Sie sie als Binärdatei laden. 

d] Binärdatei laden 

Es wird nach einem Dateinamen und nach einer (nicht notwendig anzugebenden) 
Ladeadresse gefragt. Diese Datei wird in den Speicher geladen. Wenn keine 
Ladeadresse angegeben wird, wird die Datei dort geladen, wo GEM-DOS genügend 
Speicher freigibt. MO enthält die Startadresse, Ml die Adresse des Dateiendes im 
Speicher. 

[s] Binärdatei sichern 

Dieser Befehl fragt nach einem Dateinamen, unter dem die Datei gesichert werden 
soll, nach einer Startadresse und einer Schlußadresse. Um eine zuvor geladene 
Binärdatei zu sichern, können Sie als Start- und Schlußadresse MO und Ml angeben, 
vorausgesetzt, die Werte haben sich nicht verändert. 
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(D ASCII-Datei laden 

Mit diesem Befehl können Sie eine ASCII-Datei laden, normalerweise eine Quell¬ 
textdatei, um sie in MonAm anzusehen. Fenster 4 wird geöffnet, falls es noch nicht 
vorhanden ist, und als Source-Fenster eingestellt. 

4.13.9 Programme ausführen 

I Ctrl l - fFl Zurück zum Programm / laufenlassen 

Hiermit wird das Programm mit voller Geschwindigkeit laufen gelassen; es ist die 
übliche Methode dafür, das Programm nach einem Breakpoint weiterlaufen zu 
lassen. 

I Ctrl l -fYI / 

[CtrD.[z] Single-Step 

Hiermit wird der Maschinensprachebefehl am PC ausgeführt. Ein Trap, Line-A- 
oder Line-F-Opcode wird als einzelner Befehl angesehen und als solcher ausgeführt. 
Dies kann durch Voreinstellungen verändert werden. 

I Ctrl l -in Befehl interpretieren 

Dieser Befehl interpretiert den Opcode am PC. Er ist dem I Ctrl l -fYI / 1 Ctrl l -ITI ähn¬ 
lich, verfolgt aber keine JSR-, BSR-, Trap-, Line-A- oder Line-F-Befehle. Er erspart 
Ihnen das Durchlaufen solcher Routinen und kann mit Befehlen im ROM oder im 
RAM benutzt werden. 

[Ctrll -fsl Befehl überspringen 

I Ctrl ] -in inkrementiert das PC-Register um die Größe der aktuellen Instruktion und 
bewirkt so, daß sie übergangen wird. Sie sollten diesen Befehl anstatt I Ctrl | -> [Y1 
benutzen, wenn Sie von Anfang an wissen, daß dieser Befehl ungewollte Aktionen 
auslöst. 

ß] Run 

Dies ist ein allgemeiner Befehl, der auf verschiedene Arten ausgeführt werden kann. 
Run G Go 

Dieser Befehl ist mit I Ctrl l -fFl identisch und läßt das Programm mit voller 
Geschwindigkeit laufen. 
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Run I Instruktion 

Dieser Befehl ist dem »Run S« ähnlich, nimmt aber einen numerischen Parameter: 
die Anzahl der Instruktionen, die ausgeführt werden, bevor MonAm wieder 
eingreift. 

4.13.10 Speicher durchsuchen 

G Speicher durchsuchen 

Nach diesem Befehl erscheint »Suchen nach B/W/L/T/I«, wobei die Kürzel Byte, 
Wort, Langwort, Text oder Instruktion bedeuten. 

Wenn Sie B, W oder L wählen, werden Sie nach den Zahlensequenzen gefragt, nach 
denen Sie suchen wollen. MonAm findet auch Zahlen an ungeraden Adressen. 
Wenn Sie T wählen, geben Sie den Text ein, nach dem gesucht werden soll, er wird 
dann case-sensitiv behandelt. Geben Sie 1 ein, so können Sie nach einem ganzen 
oder nur nach einem Teil eines Maschinensprachebefehls suchen. Wenn Sie z.B. 
nach »$14(A« suchen, werden Sie eine Instruktion wie »MOVE.L D2,$14(A0)« 
finden. Anders wie bei MonAm 1 wird zwischen Groß- und Kleinschreibung unter¬ 
schieden. Sie sollten auch das Ausgabeformat des Disassemblers beachten: So soll¬ 
ten Sie z.B. für Zahlen Hex-Code verwenden, sich auf A7 anstatt SP beziehen usw. 
Wenn Sie die Parameter eingegeben haben, wird die Kontrolle an den N-Befehl 
übergeben. 

N Nächstes Vorkommnis suchen 

Dieser Befehl wird nach dem G-Befehl benutzt; er sucht nach dem nächsten Vor¬ 
kommnis der angegebenen Suchparameter. Wenn Sie nach Byte-, Wort- oder Lang¬ 
wort-Daten suchen, werden Sie immer ein Vorkommnis, nämlich im MonAm- 
Speicher, finden. Wenn Sie nach Text suchen, kann es auch sein, daß der Text sich 
noch im Tastaturpuffer befindet. Mit diesen Suchparametem wird nach 64 Kbyte 
durchsuchtem Speicher die I Esc I -Taste abgefragt. Bei der Suche nach Maschinen¬ 
sprachebefehlen wird immer nach 2 Byte auf die (Esc 1 -Taste hin geprüft. 

Gesucht wird im Bereich von 0 bis zum Ende des Speichers, dann von $FA0000 bis 
SFEFFFF, dem Modul- und System-ROM Bereich, und dann wieder von 0 an. Die 
Suche beginnt kurz nach der Anfangsadresse des aktuellen Fensters (wenn es nicht 
das Register-Fenster ist). Wenn die angegebenen Daten gefunden wurden, werden 
die Stalladressen von manchen Fenstern auf die Adresse der gefundenen Daten 
gesetzt. Wenn innerhalb von Fenster 2 oder 3 gesucht wurde, werden die Start¬ 
adressen von 2 und 3 auf die gefundenen Daten gesetzt. Wenn innerhalb der Fenster 
4 oder 5 gesucht wurde, werden die Startadressen von 4 und 5 auf die gefundenen 
Daten gesetzt, außer dann, wenn Fenster 4 als Source-Fenster benutzt wird. 
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Im Source-Fenster suchen 

Wenn Sie den G-Befehl im Source-Fenster verwenden, kann nur nach Text gesucht 
werden. Wenn er gefunden worden ist, wird die Zeile, die den Text enthält, 
angezeigt. Wenn der Text nicht gefunden wurde, wird das Fenster nicht verändert. 
Daß die Suche ohne Ergebnis verlief, erkennen Sie daran, daß die Meldung 
»Suche...« nicht mehr im Mitteilungsfenster unten zu sehen ist. 

4.13.11 Verschiedenes 

1 Ctrl l -fFI Voreinstellungen 

Mit dieser Dialogbox können Sie verschiedene Optionen von MonAm einstellen. 
Die ersten drei Fragen verlangen y/A-Antworten. Sie können, wie in jeder Dia¬ 
logbox, mit [Esc] abbrechen und mit [ Return I die neuen Einstellungen übernehmen. 

Relative Offsets 

Diese Einstellung ist normalerweise eingeschaltet und beeinflußt die symbolische 
Disassemblierung vom Adreßregister indirekt mit dem Offset-Adreßmodus, d.h. 
xxx(An). Wenn die Option eingeschaltet ist, wird Jeder derartige Adreßmodus 
ausgerechnet und dann die Symboltabelle durchsucht; wenn ein Symbol sich an 
dieser Adresse befindet, wird der Befehl als Symbol(An) disassembliert. Diese 
Option ist sehr hilfreich, sowohl bei manchen Assemblerprogrammstilen als auch 
bei der Untersuchung von Hochsprachen, die ein Adreßregister als Basisregister 
benutzen. HiSoft Basic z.B. verwendet A3 als Zeiger auf das Runtime-System. 

Symbol-Optionen 

Diese Option ermöglicht es, die Behandlung von Symbolen durch MonAm zu ver¬ 
ändern. Zuerst werden Sie gefragt, wie viele Buchstaben in einem Symbol als signi¬ 
fikant gelten sollen (minimal 8, maximal 22) und danach, ob die Symbole case-sen- 
sitiv verarbeitet werden sollen. Drücken von »Y« veranlaßt eine nicht-case-sensitive 
Suche. Diese Option ist für diejenigen gedacht, die nicht Jedesmal den ganzen 
Symbolnamen eingeben und nicht auf Groß- und Kleinschreibung achten wollen. 

Oberer RAM-Bereich 

Dadurch wird MonAm angezeigt, welche Adresse im Speicher-Durchsuchen- 
Kommando (G) als oberer Speicherbereich angesehen werden soll. Normalerweise 
brauchen Sie hier keine Änderung vorzunehmen, da die Grundeinstellung 2 Mbyte 
beträgt, Jedoch ist eine Änderung erforderlich, wenn Sie mehr Speicher benötigen 
sollten. 
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Drucker 

Damit können Sie die von Ihrem Drucker benutzte Schnittstelle angeben. Der 
Defaultwert ist PRT:. 

Voreinstellungen speichern 

Antworten Sie mit 7, wenn Sie die aktuellen Voreinstellungen in MONAM2.INF 
speichern wollen. Während MonAm geladen wird, werden die Voreinstellungen 
eingelesen. MONAM2.INF muß sich im aktuellen Verzeichnis befinden. 

I Intelligentes Kopieren 

Dieser Befehl kopiert einen Speicherbereich in einen anderen. Die Adressen sollten 
folgendermaßen eingegeben werden: 

<start>,<inclusive_end>,<destination> 

Die Kopie ist insofern intelligent, als der Speicherblock auch an eine solche Stelle 
kopiert werden kann, die sich mit der vorherigen Speicheradresse überschneidet. Die 
Korrektheit der Kopie wird nicht überprüft; das Kopieren von nichtexistierenden 
Speicherbereichen läßt MonAm abstürzen. 

L Labels auflisten 

Ein großes Fenster wird geöffnet, in dem alle geladenen Symbole angezeigt werden. 
Durch Eingabe einer beliebigen Taste gelangen Sie auf die nächste Seite, durch I Esc 1 
wird die Anzeige abgebrochen. Die Reihenfolge der Anzeige entspricht der Reihen¬ 
folge, in der die Symbole auf Diskette gefunden werden. 

I Ctrl l -flT] Name Deallokation des Symbolspeichers 

Dieses Kommando kann nur dann angewendet werden, wenn Sie ein Programm 
debuggen, mit dem eine Symboltabelle geladen wurde. Mit diesem Befehl wird der 
Speicherplatz deallokiert, der für das Symbol verwendet wurde, und somit zum 
weiteren Gebrauch freigegeben. Dieser Befehl ist dann nützlich, wenn während des 
Debuggens eines umfangreichen Programms der Speicherplatz eng wird. Laden Sie 
das Programm mit den Symbolen, setzen Sie einen Breakpoint auf eine symbolische 
Adresse, und deallokieren Sie dann die Labels. Wenn der Breakpoint einmal gesetzt 
worden ist, sind alle Symbole verloren. 

W Speicher füllen 

Dieser Befehl füllt einen Speicherbereich mit dem angegebenen Wert. Die Para¬ 
meter sind: 
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<start>,<inclusive_end>,<fi11byte> 

Auch hier gilt der Hinweis darauf, daß keine Überprüfung stattfindet. 

P Disassemblieren zum Drucker/zur Diskette 

Mit diesem Befehl können Sie einen Speicherbereich zum Drucker oder auf Dis¬ 
kette, sowohl mit vorhandenen Symbolen als auch mit Cross-reference-Labels, dis¬ 
assemblieren. Die erste Zeile der Dialogbox sollte mit 
<Startadresse>,<Endadresse> 

angegeben werden. Die nächste Zeile fragt nach einem Speicherbereich, den 
MonAm zur Erstellung der Cross-reference-Liste benutzen kann: 
<Pufferanfang><Pufferende> 

Wenn Sie keinen wollen, geben Sie einfach eine leere Zeile ein. Die nächste Zeile 
fragt nach den Speicherbereichen, die als DC-Direktiven disassembliert werden 
sollen. Die Zeile sollte so aussehen: 

<Datenanfang><Datenende>[,<Größe>] 

Die optionale Größe ist die der DCs und kann B, W oder L sein, wobei L der 
Standardwert ist. Wenn alle Datenbereiche definiert wurden, geben Sie eine leere 
Zeile ein. Zuletzt wird nach einem Dateinamen gefragt. Wenn keiner angegeben 
wird, geht die Ausgabe zum Drucker. Wenn eine Cross-reference-Liste angefertigt 
werden soll, gibt es zuerst während der Erstellung eine kleine Pause. Die Labels, die 
so generiert wurden, haben das Format Lxxxxxx, wobei xxxxxx die Hex-Adresse 
des Labels ist. 

Druckerausgabe 

Das Zeilenformat enthält zuerst eine Sstellige Hex-Zahl, bis zu 10 Worten Hex- 
Daten, ggf maximal 12 Zeichen eines Symbols, und darauf den disassemblierten 
Befehl. Die Druckerausgabe kann mit [Esel abgebrochen werden. 

Diskettenausgabe 

Das Format kann direkt von GenAm verarbeitet werden. Es enthält zuerst gegebe¬ 
nenfalls ein Symbol, dann den disassemblierten Befehl, dem ein Tab vorausgeht. 
Ein Tab trennt auch den Opcode vom Operanden. Wenn Sie einen Speicherbereich 
ohne Symbole disassemblieren, ist es ratsam, die XREF-Option zu benutzen, da 
andernfalls keine Labels vorhanden sein würden. Ein Diskettenfehler oder [Esc] 
brechen die Ausgabe ab. 

M Adresse verändern 

Dieser Befehl ist aus Kompatibilitätsgründen zu MonAm 1 beibehalten worden. Er 
entspricht S-S . 
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O Auswerten 

Dieser Befehl entspricht CÄ]-[3 und ist aus Kompatibilitätsgriinden zu MonAm 1 
beibehalten worden. 

D Laufwerk und Pfad verändern 

Mit diesem Befehl können Sie das aktuelle Laufwerk und den aktuellen Pfad ver¬ 
ändern. 


4.13.12 Zusammenfassung der MonAm-Kommandos 

Fenster-Befehle 

[Ä]-[Ä] Startadresse setzen 

IÄ]-[1] Breakpoint setzen 

[Ä]-[^ Fenster editieren 

El-Ix] Fontgröße 

S-El Fenster binden 

(Tl-E Ausdruck auswerten 

[Ä]-[J] Drucker-Dump 

[Ä]-® Register setzen 

S-® Fenster spalten 

E-S Fenstertyp verändern 

S-S Fenster zoomen 


Bildschirmumschaltung 


Breakpoints 

S-E 

[Help] 

fCtdl -E 

u 

[ctTD-E 

[ctiD-B 

[HD-B 


Breakpoint setzen 
Breakpoint- und Segmentanzeigen 
Breakpoint setzen 
Go Until 

Alle Breakpoints löschen 
Breakpoint setzen und ausführen 
Ausführung des Programms anhalten 


Laden und Abspeichern 


I Ctrl i -in 

B 

S 

A 


Ausführbares Programm laden 
Binärdatei laden 
Binärdatei abspeichern 

ASCII-Datei laden und Programme ausführen 
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Programmausführung 

rctrll-d] 

Zurück zum Programm / Run 

1 Ctrl l-d) 

Single-Step 

1 Ctrl )-(T) 

Single-Step 

(Ctrl)-(I] 

Instruktion interpretieren (Trace) 

R 

Run (verschiedene Arten) 

Speicher durchsuchen 

G 

Durchsuche Speicher 

N 

Nächstes Vorkommnis 

Verschiedenes 

fCtrTl-E 

Abbrechen 

(Ctrl l-S] 

Programm verlassen 

(Ctrl )-(I] 

Voreinstellungen 

I 

Intelligentes Kopieren 

w 

Speicher füllen 

L 

Labels anzeigen 

(ttül-El 

Symbole deallokieren 

P 

An Drucker/Diskette disassemblieren 

M 

Adresse verändern 

0 

Auswerten 

D 

Laufwerk und Pfad verändern 

H 

History-Speicher anzeigen 


4.14 Fehlersuche 

4.14.1 Beschränkungen 

MonAm ist beim Ablauf abhängig von der Exec-, Intuition- und Grafik-Bibliothek. 
Wenn Ihr Programm illegalerweise Speicher zerstört, kann es möglich sein, daß 
dadurch unwiderruflich etwas verlorengeht, was das System unbedingt braucht. Die 
Maschine stürzt dann ab, wenn MonAm nach einer Exception aufgerufen wird. 
Dieser Fehler ist jedoch selten, normalerweise treten Adreßfehler auf, bevor ein 
Programm Speicherplatz zerstört. Wenn ein Programm von MonAm aus aufgerufen 
wird, sieht es aus, als ob es vom CLI - und nicht von der Workbench aus - gestartet 
worden wäre. 
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Im Supervisor-Modus kann MonAm jeden Code single-steppen oder darin inte¬ 
grierte Breakpoints bearbeiten. Die Ursache dafür ist, daI3 der Exec-Exception- 
Handler im Supervisor-Modus auf eine Exception hin überprüft und, falls dies der 
Fall sein sollte, eine Guru-Meldung ausgibt. Ansonsten geht er in MonAm und 
arbeitet normal weiter. Wenn Ihr Programm ein weiteres Programm oder eine 
weitere Task erzeugt, kann MonAm dieses nicht single-steppen oder Breakpoints 
darin abarbeiten. MonAm kann nur das Programm debuggen, das anfänglich 
geladen wurde. 

Versuchen Sie nicht, in MonAm Standard-System-Programme wie z.B. »dir« laufen 
zu lassen, da diese Programme auf nicht dokumentierten Registern (besonders A5) 
und auf Speicherbereichen basieren, die MonAm nicht emulieren kann. Ein Wort¬ 
oder Langwortzugriff auf einen ungeraden Speicherplatz von 1 bis 7 verursacht 
einen kompletten Hardware-Absturz. Leider gibt es nichts, was man dagegen unter¬ 
nehmen kann. 

4.14.2 Die Bug-Jagd 

Es gibt wahrscheinlich genauso viele Bug-Jagd-Strategien, wie es Programmierer 
gibt, aber die Erfahrung ist doch der beste Lehrer. Wir haben in der Zeit, in der wir 
den 68000er programmierten, gelernt, wie man die Suche am besten angeht. 

Zunächst ist es ein sehr guter Weg, sich den Quelltext anzusehen, um Fehler zu 
finden. Es ist eine schlechte Angewohnheit, zuerst zum Debugger zu greifen. Es 
könnte sein, daß Sie dabei das System oder die Programmierumgebung wechseln 
und nicht mehr auf das Low-level-Debuggen zurückgreifen können. 

Wenn ein Programm offensichtliche Fehler macht, wie z.B. einen Adreßfehler, ist es 
wesentlich leichter, das Problem zu finden, als wenn das Programm nur manchmal, 
von Ihrer Sicht aus völlig unberechenbar, das falsche Ergebnis liefert. 

Viele Fehler entstehen dadurch, daß bestimmte Speicherbereiche, die wichtige 
Daten enthalten, versehentlich überschrieben werden. Wenn man den Speicher¬ 
bereich leicht erkennen kann, wie z.B. bei einem Busfehler, kann man bedingte 
Breakpoints an verschiedenen Stellen in Ihrem Programm unterbringen, um so den 
Fehler so früh wie möglich abzufangen. Nehmen wir z.B. an, daß die globale 
Variable »main_ptr« während der Ausführung ungerade wird. Der bedingte Aus¬ 
druck sollte so aussehen: 

{main__ptr}&l 

Zählerbreakpoints sind eine gute Methode dafür, Bugs abzufangen, bevor sie auf- 
treten. Nehmen wir an, daß Sie von einer bestimmten Subroutine wissen, daß sie 
abstürzt. Sie den Fehler aber nicht kennen. Setzen Sie also einen Breakpoint auf sie 
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und lassen Sie das Programm laufen. An der Stelle, an der d as Pro gramm wegen 
z.B. einer Exception unterbrochen wird, sollten Sie sich mit I Help I den Wert des 
Zähler-Breakpoints ansehen. Beenden Sie das Programm, laden Sie es wieder, 
setzen Sie dann einen Stop-Breakpoint auf die spezielle Subroutine für den 
speziellen Wert oder zumindest einen vor sie. Lassen Sie das Programm dann 
ablaufen. Sie können so den Ablauf durch die Subroutine verfolgen. Viel Glück! 

4.14.3 Exception-Analyse 

Wenn eine unerwartete Exception auftaucht, ist es ganz nützlich zu wissen, warum 
und wo sie geschah, um dann Gegenmaßnahmen zu ergreifen. 

Busfehler 

Wenn der PC sich in nichtexistentem Speicher befindet, schauen Sie sich den Stack 
an und versuchen Sie, eine Rückkehradresse zu finden. Diese gibt meist Aufschluß 
über den Grund des jetzigen PC-Wertes. Wenn der PC sich innerhalb Ihres Pro¬ 
gramms befindet, hat vermutlich ein Zugriff auf einen nichtexistenten oder 
geschützten Speicher den Busfehler ausgelöst. Es ist sehr unwahrscheinlich, daß Sie 
nach einem Busfehler Ihr Programm weiterlaufen lassen können. 

Adreßfehler 

Wenn der PC sich nicht in Ihrem Programm befindet, ist die soeben erwähnte 
Methode anzuwenden. Ein Adreßfehler hat als Ursache meist einen Wort- oder 
Langwortzugriff auf eine ungerade Adresse. Eine Registerkorrektur hilft oft, daß das 
Programm wenigstens für eine Weile weiterlaufen kann. 

Illegaler Befehl 

Wenn der PC in einem sehr niedrigen Speicherbereich ist, etwa unter $30, ist meist 
ein Sprung an die Adresse 0 schuld. Wenn Sie sich mit MonAm diesen Bereich 
ansehen, erkennen Sie mehrere ORI-Befehle, die in Wirklichkeit Langwortzeiger 
sind, dicht gefolgt von einem illegalen Befehl. 

Privilegverletzung 

Dies wird durch die Ausführung eines privilegierten Befehls im User-Modus ver¬ 
ursacht. Meistens bedeutet dies, daß Ihr Programm Amok gelaufen ist. 


Anhang 


A 


AmigaDOS- 

Fehlernummern 


Dargestellt sind die Fehlemummern, die teilweise erscheinenden englischen Texte, 
deren Übersetzung, und, wenn nötig, zusätzliche Erklärungen. 

103 insufficient free störe 
nicht genug freier Speicher 

104 task table full 

Task-Tabelle voll (mehr als 20 CLIs) 

120 argument line invalid or too long 

Argument-Zeile ungültig oder zu lang (bei CLI-Kommandos) 

121 file is not an object module 

File ist kein Objekt-Modul (kann nicht ausgeführt werden) 

122 invalid resident library during load 

ungültige residente Library während des Ladens festgestellt 

202 object in use 

Objekt in Gebrauch (z.B. File durch anderes Programm) 

203 object already exists 
Objekt existiert bereits 

204 directory not found 
Directory nicht gefunden 

205 object not found 

Objekt nicht gefunden (File nicht gefunden) 

206 invalid window 

ungültige Window-Spezifikation (CON:/RAW:-Window) 

209 packet request type unknown 
Typ unbekannt 






104 Anhang A 


210 invalid stream component name 

Name ist zu lang oder enthält [ Ctrl I -Zeichen 

211 invalid object lock 
Ungültiges Lock 

212 object not of required type 
Objekt ist vom falschen Typ 

213 disk not validated 

Diskette wird noch geprüft oder ist defekt 

214 disk write protected 
Diskette ist schreibgeschützt 

215 rename across device attempted 

Bei »Rename« verschiedene Laufwerke angegeben 

216 directory not empty 

Directory nicht leer (muß es vor dem Löschen sein) 

218 device not mounted 

Device (Laufwerk) nicht angemeldet 

219 seek error 

Fehler beim Suchen eines Records 

220 comment to big 
File-Kommentar zu groß (>80 Zeichen) 

221 disk full 
Diskette voll 

222 file is protected from deletion 
File ist gegen Löschen geschützt 

223 file is protected from writing 
File ist schreibgeschützt 

224 file is protected from reading 
File ist lesegeschützt 

225 not a DOS disk 
keine DOS-Diskette 

226 no disk in drive 

Keine Diskette im Laufwerk 

232 no more entries in directory 

Keinen Directory-Eintrag (File-Namen) mehr gefunden 




GenAm kann eine große Zahl von Fehlemieldungen ausgeben. Die meisten davon 
erklären sich von selbst. Dieser Anhang bringt sie in der numerischen Reihenfolge 
in Englisch und Deutsch, gegebenenfalls mit Erklärungen. 

Bitte beachten Sie, daß GenAm laufend erweitert und noch verbessert wird. Deshalb 
kann diese Liste nicht genau mit Ihrer Version übereinstimmen, weil neue Mel¬ 
dungen hinzugekommen sind. 

B.1 Fehlermeldungen 

Wenn Sie eine mit INTERNAL beginnende Meldung erhalten - was niemals 
Vorkommen sollte -, so teilen Sie uns das bitte mit. 

Meldung Bemerkung 


.W or .L expected as index size 

.W oder .L werden als Indexgröße erwartet 

absolute expression MUST evaluate 
Absoluter Ausdruck muß lösbar sein 

absolute not allowed 
Absoluter Ausdruck nicht erlaubt 

Es erschien ein Label in Paß 2, 
nicht aber in Paß 1 


additional Symbol on pass 2 
Zusätzliches Label in Paß 2 
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Meldung 


Bemerkung 


address register expected 
Adreßregister erwartet 

addressing mode not allowed 
Adressierungsart nicht erlaubt 

addressing mode not recognized 
Adressierungsart nicht bekannt 

BSS or OFFSET section cannot contain data OFFSET- und BSS-Sektionen 


BSS- oder OFFSET-Sektion kann keine 
Daten enthalten 

cannot create binary file 
Kann keine Binärdatei erzeugen 

cannot export Symbol 
Kann Symbol nicht exportieren 

cannot import Symbol 
Kann Symbol nicht importieren 

cannot nest MACRO definitions or 
define in REPTs 

Kann Makro-Definitionen in REPTs 
nicht verschachteln oder definieren 

cannot nest repeat loops 

Kann Wiederholungsschleifen nicht 

verschachteln 

comma expected 
Komma erwartet 

data register expected 
Datenregister erwartet 


können nur DS-Direktiven 
enthalten 

Falscher Dateiname, schreib¬ 
geschützte Diskette, o.ä. 


Makro-Definitionen dürfen in 
Wiederholungsschleifen nicht 
verschachtelt oder definiert werden 
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Meldung 


Bemerkung 


data too large 
Daten zu groß 

division by zero 
Division durch Null 

duplicate MODULE name 
Modulnamen kopieren 

module names must be unique 
Modulnamen müssen einheitlich sein 

error during listing output 
Fehler während der Listing-Ausgabe 


executable code only 
Nur ausführbarer Code 

expression mismatch 
Fehler im Ausdruck 

fatally bad conditional 
Fataler Fehler in Bedingung 

file not found 
Datei nicht gefunden 

forward reference 
Vorwärts-Referenz 

garbage following instruction 
Nach Befehlswort folgt Unsinn 


Listing wird an dieser Stelle 
abgebrochen 

Normalerweise Diskette voll 

In den Speicher kann nur ausführ¬ 
barer Code assembliert werden 

Normalerweise ein Syntaxerror in 
einem Ausdruck 

In einem Makro wurden mehr 
ENDCs als IFs verwendet 


error during writing binary file 

Fehler während des Schreibens der Binärdatei 



108 AnhangB 


Meldung Bemerkung 


illegal BSR.S 
Illegaler BSR.S 


illegal type combination 
Illegale Typkombination 

immediate data expected 
Konstante erwartet 

imported label not allowed 
Importiertes Label nicht erlaubt 

include file read error 
Datei-Lesefehler enthalten 

instruction not recognized 
Unbekannter Befehl 

invalid FORMAT parameter 
Ungültige Format-Parameter 

invalid INCDIR 
Ungültige INCDIR 

invalid IF expression, ignored 
Fehlerhafter IF-Ausdruck, wird ignoriert 

invalid MOVEP addressing mode 
Fehlerhafte MOVEP-Adressierungsart 

invalid number 
Ungültige Zahl 

invalid numeric expansion Das Symbol ist nicht definiert oder 

Ungültige numerische Ausweitung relativ bzw. liegt ein Syntax-Error 

vor 


Sie haben mehr als 500 Byte für 
Verzeichnisangaben verbraucht 


Ein BSR.S ist für die folgende 
Anweisung nicht erlaubt - in BSR 
umändem 
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Meldung 


Bemerkung 


invalid Option 
Ungültige Option 

invalid printer parameter 
Ungültige Drucker-Parameter 

invalid register list 
Ungültige Register-Liste 

invalid section name, TEXT assumed 
Ungültiger Sektionsname, Text 
wird angenommen 

invalid size 
Ungültige Größe 

line malformed 
Zeile schlecht formuliert 

linker format restriction Das AmigaDOS-Format unterliegt 

Einschränkung im Linker-Format Einschränkungen bezüglich auf 

erlaubte Importe. 

Vgl. Sektion 3.10.2 


local not allowed 

Lokale Adressierung nicht erlaubt 

missing dose bracket 
Fehlende Schließ-Klammer 

missing ENDC Es wurden mehr IFs als ENDCs 

Fehlendes ENDC verwendet 

missing quote 

Fehlendes Anführungszeichen 
misuse of label 

Fehlerhafter Gebrauch von Label 
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Meldung 


Bemerkung 


not yet implemented 
Noch nicht implementiert 

number too large 
Zahl zu groß 

odd address 
Ungerade Adresse 

Option must be at Start 
Option muß am Anfang stehen 

ORG not allowed 
ORG nicht erlaubt 

out of memory 
Kein Speicher mehr 

phasing error Sollte niemals passieren 

Phasenfehler 

program buffer full Wenn in den Speicher assembliert 

Programmpuffer voll wird, Größe des Programmpuffers 

verändern 

register expected 
Register erwartet 

relative not allowed 

Relative Adressierung nicht erlaubt 

relocation not allowed 
Relozierung nicht erlaubt 

repeated include file 
Wiederholte Include-Datei 
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Meldung 


Bemerkung 


each include file may only be included 
once on each pass 

Jede Include-Datei darf nur einmal pro Paß 
eingebunden werden 

source expired prematurely 
Source-Überfluß 

spurious ENDC 
Falsches ENDC 

spurious ENDM or MEXIT 
Falsches ENDM oder MEXIT 

spurious ENDR 
falsches ENDR 

Symbol defined twice 
Symbol zweimal definiert 

Symbol expected 
Symbol erwartet 

undefined symbol 
Undefiniertes Symbol 

user Error 
Benutzer-Fehler 

wrong processor 
Falscher Prozessor 

XREFs not allowed within brackets 
In Klammern keine XREFs erlaubt 


Durch eine falsche Direktive 
verursacht 


Innerhalb eines IF, MACRO oder 
REPT fließt Source über 
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B.2 Warnungen 

Meldung Bemerkung 


68010 Instruction, converted to MO VE SR MO VE CCR ist keine 68000- 

68010-Instruktion, zu MO VE SR konvertiert Instruktion 

brauch made short durch Optimierung 

Branch-Verkürzung 

directive ignored 
Direktive wird ignoriert 


invalid LINK displacement Wenn größer als 0 oder ungerade 

Ungültige LINK-Anzeige 

offset removed 
Offset entfernt 

relative cannot be relocated 
Relative Adresse kann nicht reloziert werden 

short branch converted to NOP 
Kurzer Sprung wird zu NOP 

sign extended Operand MOVEQ benötigt Vorzeichen bei 

Operanden kennzeichnen Daten 


xx(An) wurde durch Optimierung 
in die Form (An) reduziert 


size should be .W 
Größe sollte .W betragen 




Anhang 


c 


Aufruf von 
System-Routinen 


C.1 Einführung 

Das Amiga-Betriebssystem ist mit Sicherheit eines der hochentwickeltsten aller 
Computer in Massenproduktion, aber auch das komplizierteste. Das ganze System 
basiert auf dem Libraries-Konzept, die im Prinzip Gruppen von Unterprogrammen 
(Funktionen für C-Programmierer) sind und über eine Indextabelle aufgerufen 
werden. Dieser Anhang will Ihnen grundsätzlich erklären, wie man Library-Routi¬ 
nen von Assembler aus aufruft, und soll Ihnen eine Vorstellung davon geben, wofür 
welche Routinen eingesetzt werden können. Ein kleiner Anhang kann nicht das 
ganze Betriebssystem erklären, er ist nur als Einführung gedacht. Für weitergehende 
Informationen sind die Bücher in den Literaturhinweisen zu empfehlen. 


C.2 Libraries 

Die wichtigste Library ist die Exec-Library, die unter anderem auch dafür gebraucht 
wird, andere Libraries zu öffnen. Wie für alle Libraries benötigt man einen Library- 
Basiszeiger, der in das Register A6 geladen werden muß, bevor man eine Routine 
der Lib aufrufen kann. Nur die Exec-Lib muß nicht geöffnet werden, um einen 
Basiszeiger zu erhalten; dieser Zeiger steht im Langwort ab Adresse 4. Das ist die 
einzige Adresse, für die garantiert ist, daß sie sich nicht ändert. Der daraus gelesene 
Basiszeiger kann benutzt werden, um andere Libs zu öffnen und damit deren Basis¬ 
zeiger zu erhalten und so weiter. Beachten Sie, daß die meisten Libs den Basiszeiger 
in A6 erwarten, wenn sie korrekt funktionieren sollen. Das liegt daran, daß viele 
Routinen selbst wieder Routinen derselben Lib aufrufen und dabei unterstellen, daß 
der Basiszeiger schon in A6 ist. Parameter werden an Library-Routinen in Registern 
übergeben, wobei als allgemeine Regel gilt, daß dO/dl und aO/al nach jedem Aufruf 
verändert sein können. Die Hauptausnahme von dieser Regel macht die Graphics- 
Library, worauf später noch eingegangen wird. 
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Mit Devpac wird eine große Anzahl von Include-Files geliefert, um einen einfachen 
Zugriff auf die verschiedenen Teile des Betriebssystems zu ermöglichen. Diese 
Include-Files enthalten Makro-Definitionen, Symbole für die Library-Offsets, Defi¬ 
nitionen von Datenstrukturen und Symbole für Bit-Felder. Es folgt nun eine Tabelle, 
die die Namen der verschiedenen Komponenten zeigt und wo diese im Include- 
Directory zu finden sind. Darin bedeuten: 

File: File mit den Makro-Definitionen und den _LVO-Offsets zum Aufruf der 
Library-Routinen. 


Library 

Ffle 

Name macro 


Base pointer 

Galling macro 

diskfont 

libraries/diskfont_llb.l 

DISKFONTNAME 


_DiskfontBase 

CALLDISKFONT 

dos 

Ubraries/dos^lib.l 

DOSNAME» 


_DOSBase 

CALLDOS 

exec 

exec/exec_lib.i 

EXECNAME 


„SysBase 

CALLEXEC 

expansion 

libraries /expansion_llb. i 

EXPANSIONNAME2 


_ExpanslonBase 

CALLEXP 

graphics 

graphics /graphics Jib. i 

GRAFNAME 


^GfxBase 

CALLGRAF 

icon 

workbench/icon_lib.i 

ICONNAME 


JconBase 

CALLICON 

Intuition 

intuition/ intuition_lib. i 

INTNAME 


_IntuitionBase 

CALLINT 

mothffp 

math/mathffp_lib.i 

FFPNAME 


_MathBase 

CALLFFP 

mothdouble 

math/mathieeedoubbas_llb. i 

lEEEDOUBNAME 


_MathIeeeDoubBasBase CALLIEEEDOUB 

mothtrons 

math / math trans_lib. i 

MATHTRANSNAME 


.MathTransBase 

CALLMATHTRANS 

tronslotor 

libraries / translator^lib. i 

TRANSNAME 


_TranslatorBase 

CALLTRANS 


Name macro: Dieser Makro besteht normalerweise aus einer DC.B-Anweisung für 
den Namen (in ASCII) gefolgt von einem Null-Byte. 

Base pointer: Dies ist die symbolische Adresse (Label), auf der der Basiszeiger 
abgelegt werden sollte. Das Symbol beginnt immer mit einem Unterstrich (_), auch 
wenn die meisten C-Compiler dieses Zeichen nicht listen. 
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Calling macro: Dies ist der Name des Makros, mit dem eine bestimmte Library- 
Routine aufgerufen wird. Beachten Sie, daß dieses Makro A6 verändert, da es mit 
dem Basiszeiger geladen wird. 

Neu ist: expansion in libraries/expansionjib.i. Name: EXPANSIONNAME. Basis¬ 
zeiger: _ExpansionBase. Makro: CALLEXP. 

Zum Beispiel wäre der passende Aufruf für die Funktion »OpenLibrary« 

CALLEXEC OpenLibrary 
Dieses Makro wird entwickelt als 
move.l (_SysBase).w,a6 

jsr _LV00penLibrary(a6) 

C.2.1 Diskfont-Library 

Dies ist die Library zum Umgang mit Fonts, die normalerweise auf der Disk sind. 
Files: libraries/diskfont.i und diskfontjib.i 

C.2.2 DOS-Library 

Diese ist eine der am einfachsten zu benutzenden Libraries und behandelt das File- 
1/0 (Input/Output) zu Geräten einschließlich Disketten und der Konsole. Diese Lib 
hat einige kleine Besonderheiten. Bemerkenswert ist, daß Adressen in Daten- 
registem übergeben werden müssen und viele Zeiger vom Typ BCPL sein müssen 
(d.h. Adresse dividiert durch 4 auf eine Langwortgrenze justiert). 

Files: libraries/dos.i, dosjib.i und dosextens.i 

C.2.3 Exec-Library 

Dies ist die Library auf der untersten Ebene. Sie ist zum Beispiel zuständig für 
Speicherverwaltung, Library-Öffnen und Nachrichtenübergabe. Die Library darf 
niemals geöffnet werden, ihr Basiszeiger steht auf Adresse 4. 

Files: exec/ables.i, alerts.i, devices.i, errors.i, exec.i, execbase.i, execname.i, 
execjib.i, funcdef.i, intializers.i, interrupts.i, io.i, libraries.i, lists.i, memory.i, 
nodes.i, ports.i, resident.!, strings.i, tasks.i und types.i 
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C.2.4 Graphics-Library 

Diese Lib ist für alles zuständig, was auf Ihrem Monitor erscheint, zum Beispiel 
Zeichnen von Linien, Ausgabe von Text, Kontrolle von Rast~Ports, Sprites und 
Fonts. Beachten Sie bitte, daß in der Kickstart-Version 1.1 die Text-Routine 
Register D7 verändert. Dies kann auch Auswirkungen auf andere Routinen haben, 
besonders auf die Routine »DoIO« bei der Konsole-Ausgabe. 

Files: graphics/clip.i, copper.i, display.i, gels.i, gfx.i, gfxbase.i, graphicsjib.i, 
layers.i, rastport.i, regions.i, sprite.i, text.i, view.i 

C.2.5 Icon-Library 

Diese Lib ist zuständig für den Umgang mit Icons, die auf der Workbench angezeigt 
werden. 

Files: workbench/icon.i und iconjib.i 

C.2.6 Intuition-Library 

Diese Library ist die größte und zuständig für die Bedienungsoberfläche Intuition. 
Sie verfügt über eine sehr große Anzahl von Funktionen wie die Kontrolle von 
Windows, Screens, Gadgets, Requestem und dem Event-Handling. Das Hauptfile ist 
groß und lädt mit Include noch andere Files nach. Seien Sie nicht überrascht, wenn 
es eine Weile dauert, bis alles geladen ist! Es kann sich durchaus lohnen, eine eigene 
Version zu erstellen, in der die weniger oft benutzten Konstanten und Include-Files 
nicht enthalten sind. 

Hinweis des Übersetzers: Schauen Sie sich die Include-Files an. Es ist oft sehr 
wenig, was da »included« wird und lohnt kaum den Disk-Zugriff. Andererseits 
werden oft große Files nachgeladen, obwohl man daraus nur eine oder zwei Kon¬ 
stanten braucht. 

Files: intuition/intuition.i und intuition_lib.i 

C.2.7 Maths-Libraries 

Es gibt drei Mathematik-Libraries, die alle auf den offiziellen Motorola-Routinen 
basieren. Die FFP- (Fast Floating Point = schnelles Fließkomma) Library rechnet 
mit einem 8-Bit-Exponenten und einer 24-Bit-Mantisse. Das Format wurde von 
Motorola für die 68000er entwickelt und ist kein Standardfonnat. Die »IEEE 
double«-Library bietet doppelte Genauigkeit im lEEE-Format und die 
»Transzendenten«-Lib trigonometrische und andere Funktionen im FFP-Format. 
Files: math/mathffp_lib.i, mathieeedoubbas_lib.i und mathtransjib.i 
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Generell sollten Sie GenAmiga im case-sensitiven Modus (wie voreingestellt) 
benutzen, wenn Sie die mitgelieferten Include-Files einsetzen. Beachten Sie, daß 
jedes Include-File automatisch alle Include-Files lädt, die es benötigt, so daß Sie 
sich darum nicht kümmern müssen. 

C.3 Beispielprogramme 

Um Ihnen den Anfang in der Programmierung von AmigaDOS in Assembler zu 
erleichtern, haben wir einige Beispielprogramme im Directory »example« vor¬ 
gesehen: 

C.3.1 demo.s 

Dies ist das Programm, das in der Einführung zu Beginn dieses Handbuches benutzt 
wurde. Es nutzt die DOS-Library und gibt einen Text im aktuellen CLI-Fenster aus. 

C.3.2 freemem.s 

Dieses Programm unter Intuition öffnet ein Fenster, in dem der freie Hauptspeicher 
ständig angezeigt wird, bis das Schließ-Gadget angeklickt wird. Um das Programm 
als zum CLI parallele Task laufen zu lassen, geben Sie das CLI-Kommando »run 
freemem« ein. 


C.3.3 helloworld.s 

Dies ist die Assembler-Umsetzung des C-Programms (letzte Version) »Simple 
Program«. Die Umsetzung wurde in keiner Weise optimiert. So ist es zum Beispiel 
wesentlich effektiver, die Zuweisungen für »NewScreen« durch DC-Befehle zu 
ersetzen. Das Programm öffnet einen Screen, darauf ein Window und druckt dann 
einen Text. 

C.4 Vergleich CLI / Workbench 

Es gibt zwei Programmumgebungen auf dem Amiga, die Window- und Icon¬ 
gesteuerte Workbench und das CLI. Devpac-Amiga selbst läuft unter letzterem, wie 
auch die meisten Beispielprogramme. Der Unterschied liegt im Startup- und Exit- 
Code. 


118 Anhang C 


C.4.1 CLI-Start 

Wenn ein Programm vom CLl aus gestartet wird, enthält Register AO die Adresse 
der Kommandozeile und DO deren Länge. Die DOS-Handles, die die Funktionen 
»Input« und »Output« zurückgeben, können für die Ein-/Ausgabe vom bzw. zum 
aktuellen CLI-Fenster benutzt werden. Solche Programme enden mit einem 
einfachen RTS. 

C.4.2 Workbench-Start 

Wenn ein Programm von der Workbench gestartet wurde, muß es zuerst auf eine 
Nachricht warten und diese Nachricht (nach einem Forbid-Aufruf) zurückgeben, 
bevor es mit RTS endet. Die DOS-Funktionen Input und Output geben ungültige 
Handles zurück, weshalb Sie ein eigenes Fenster für die Ein-/Ausgabe öffnen 
müssen. 

Eine abgemagerte Version dieses Programms für Assembler-Programmierer finden 
Sie im File »misc/easystart.i«. Dieses File wird auch vom Beispielprogramm 
»freemem2.s« eingezogen. Das Include-File sollte ziemlich zu Beginn Ihres Pro¬ 
gramms eingefügt werden. Es erledigt die Nachrichtenübergabe so, daß das 
Programm von der Workbench aus gestartet werden kann. Natürlich benötigen Sie 
dazu ein Icon, das mit IconEd erstellt werden kann. 


C.5 Andere 68000-Prozessoren 

Wenn Sie kommerzielle Programme für den Amiga schreiben, sollten Sie bedenken, 
daß einige Anwender einen 68010 oder 68020 anstatt des üblichen 68000 einsetzen. 
Das einzige Problem dabei ist der »MOVE SR«-Befehl, der beim 68010 und 68020 
privilegiert ist. Zur Lösung des Problems bietet die Exec-Library die Routine 
GetCC, welche die Condition-Codes im Register DO zurückgibt. Sie gebraucht keine 
anderen Register und braucht (so der Ist-Stand) auch nicht den Library-Basiszeiger 
in A6. Um zum Beispiel die Condition-Codes auf den Stack zu bringen, schreiben 


Sie anstatt 

move 

sr,-(sp) 


besser 

movea.l 

4.w,a0 

hole Basiszeiger 

jsr 

_LV0GetCC 

Aufruf von GetCC 

move.w 

dO,-(sp) 

CCs auf den Stack 

move 

dO.ccr 

und Codes setzen 
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Die Routine nutzt »AO« als Arbeitsregister. Am besten schreiben Sie das als Makro, 
um ein versehentliches Ändern des Condition-Code zu vermeiden (»movea« ändert 
sie nicht). 

Der einzige weitere Unterschied ist der wesentlich größere Stackbereich, den die 
68010/68020-Prozessoren im Falle von Exceptions füllen. Doch das dürfte nur 
Debugger und ähnliche Programme betreffen. 
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D.1 Einführung 

Wie die meisten Programmentwicklungs-Tools ist auch Devpac Amiga für den Ein¬ 
satz unter dem CLI (Command Line Interface) vorgesehen. Wenn Sie sich die 
Diskette von der Workbench aus ansehen, werden Sie deshalb wenige (oder keine) 
Icons sehen. 

Devpac Amiga wird mit seiner eigens modifizierten Workbench-Diskette geliefert, 
die die Workbench-Bedienungsoberfläche nicht lädt, sondern direkt ins CLI geht. 


D.2 Files, Laufwerke und Directories 

AmigaDOS-Files können auf Diskette, der RAM-Disk oder auf einer Hard-Disk 
gespeichert werden. Weil Disketten 800 Kbyte Daten enthalten können und Hard- 
Disks sogar noch mehr, erlaubt AmigaDOS Directories. Das sind mit Namen 
bezeichnete Sektionen auf den Disks, die Files oder Directories enthalten können. 
(Wenn Sie die Workbench benutzen, heißen Directories Drawers (Schubladen).) Um 
ein File innerhalb eines Directories anzusprechen, wird das »/«-Zeichen benutzt. 
Wenn Sie also ein File mit dem Namen »test.s« editieren wollen, der im Directory 
»source« steht, gilt das Kommando 

genam2 source/test.s I Return I 

Beachten Sie, daß das CLI Groß- und Kleinbuchstaben nicht unterscheidet, weshalb 
die Eingabe 

GenAm2 Source/Test.s I Return ] 
dasselbe bewirkt. 
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Der Aufruf von GenAm ist ähnlich dem der meisten CLI-Kommandos. Sie bestehen 
aus einem Kommando (hier GenAm), dem optional noch etwas folgt, das man 
Kommandozeile nennt. 

Wenn Sie wissen wollen, welche Files auf der Disk sind, geben Sie 
dir [Return] 

ein. Daraufhin werden alle Files gezeigt (dir heißt zeige DIRectory). AmigaDOS 
kann dafür länger brauchen als andere Systeme, seien Sie also geduldig. Wenn es 
Directories auf der Disk gibt, werden diese zuerst angezeigt, und zwar gefolgt von 
»(dir)«. Darauf folgen die File-Namen in alphabetischer Reihenfolge. 

Unglücklicherweise kümmert sich AmigaDOS nicht um die Schreibweise der File- 
Namen hinsichtlich Groß-/Kleinbuchstaben, jedoch erfolgt die Unterscheidung im 
Ausdruck. Dies liegt darin begründet, daß der Name in der Schreibweise benutzt 
wird, der beim Anlegen des Files oder Directorys gewählt wurde. 

Das CLI greift immer auf das aktuelle Laufwerk und Directory zu. Mit dem cd- 
Kommando können Sie den jeweiligen Stand erfragen und ändern. Nach dem 
Booten mit einer Kopie der Devpac-Diskette ist die aktuelle Disk DFO: (DFO: = 
internes, DFl: = externes Laufwerk). Sie können das testen mit 

cd [ Return 1 

Tippt man nur »cd« ein, wird immer das aktuelle Directory angezeigt. Wenn Sie in 
ein anderes Directory wechseln wollen, zum Beispiel in das mit den Beispiel¬ 
programmen, müssen Sie »cd« noch den Namen folgen lassen, d.h. 

cd examples 1 Return 1 

Wenn Sie jetzt »dir« eingeben, sehen Sie eine Liste von Files. Geben Sie nun nur 
»cd« ein, sollten Sie »DFOiexamples« sehen. 

Um sich Textfiles anzusehen, die mit ».s« enden, können Sie zum Beispiel eingeben 
type demo.s [Return 1 

Das zeigt den Inhalt von »demo.s« auf dem Schirm. Um das (durchlaufende) Bild 
anzuhalten, können Sie die rechte Maustaste drücken; um das Listing vorzeitig 
abzubrechen, geben Sie [ Ctrl l -fcl ein. 

Um in das vorherige Directory zurückzukommen, geben Sie ein 
cd dfO; 1 Return ] 
oder alternativ 


cd : I Return 1 
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Der Doppelpunkt alleine bezeichnet das Directory auf der obersten Ebene (Root- 
Directory). Wenn wir uns nun »demo.s« noch einmal ansehen wollen, können wir 
wieder das Directory wechseln, aber einfacher ist es, das Directory zusammen mit 
dem File-Namen anzugeben, also 

type examples/demo.s IReturn| 

Beachten Sie die Art, wie der Schrägstrich (/) eingesetzt wird. 

D.3 AmigaDOS-Wildcards 

Wildcards sind Platzhalter für beliebige Zeichen oder Zeichenfolgen. AmigaDOS 
hat unglücklicherweise eine völlig unterschiedliche Lösung für Wildcards als andere 
Betriebssysteme. Zugegebenermaßen besitzt man damit viel mehr Möglichkeiten für 
die Arbeit, dennoch ist die AmigaDOS-Version nicht sehr einfach zu verstehen. Hier 
eine Zusammenfassung: 

? ein einzelnes Zeichen 

% Nullstring 

#<p> ein- oder mehrfaches Auftreten des Musters <p> 

<pl> I <p2> Entweder Muster pl oder Muster p2 
0 faßt Muster zusammen 

Im allgemeinen braucht man davon das »?«, das sich von selbst erklärt, und »#?«, 
was dem »*« von MS-DOS und CP/M entspricht. 


D.4 Gerätenamen 

Alle I/O-Geräte des Amiga haben Namen, über die sie in CLI-Kommandos und in 
Programmen angesprochen werden können. Es sind kurze Namen, die mit einem 
Doppelpunkt enden. Tatsächlich haben Sie schon zwei davon kennengelemt, näm¬ 
lich die beiden Floppy-Laufwerke DFO: und DFl:. Hier ist der Rest: 

D.4.1 RAM: 

Dies ist die RAM-Disk, die wie ein normales Laufwerk eingesetzt werden kann. Sie 
ist allerdings sehr viel schneller, weil die Daten direkt im Hauptspeicher auf¬ 
gezeichnet werden. Ihr Nachteil ist, daß die Daten verlorengehen, wenn der Rechner 
ausgeschaltet wird, ein Reset erfolgt oder Ihr Programm etwas verrückt spielt. Die 
RAM-Disk ist dynamisch, d.h. sie belegt immer nur so viel Speicher, wie für das 
jeweilige Datenvolumen benötigt wird. 





124 Anhang D 


Anmerkung zu Kickstart 1.1: Wenn man die RAM-Disk bis zum letzten Byte füllt, 
stürzt das System ab, weil es ohne Erfolg (mangels RAM) versucht, die Meldung 
»Disk voll« auszugeben. 

DA2 RAD: 

Unter der Workbench 1.3 ist RAD: eine RAM-Disk, die sich von RAM: auf zwei 
Arten unterscheidet: 

• Ihre Größe ist auf mount-time fixiert. 

• Sie überdauert einen Warmstart mit I Ctrl I - rechte (T] - linke (T) und kann mit 
einem Kickstart gelöscht werden. 

DA3 PAR: 

Dies ist der Parallel-Druckerport, der normalerweise nur für die Ausgabe (Output) 
eingesetzt wird. 

DA4 SER: 

Dies ist die serielle Schnittstelle, die für Ein- und Ausgabe benutzt werden kann, 
normalerweise zu Druckern und Modems. 

DAS PRT: 

Dies ist der allgemeine Druckerport, der mit Voreinstellungen konfiguriert wird. 
Hierfür muß das Programm nicht wissen, an welchem Port (PAR: oder SER:) der 
Drucker hängt oder welcher Druckertyp angeschlossen ist. 

DAS NIL: 

Dies ist ein Dummy-Gerät, auf das man Ausgaben ins Nichts schicken kann. Der 
Versuch von NIL: zu lesen, generiert die Fehlermeldung »end of file«. 

DA7 CON: 

Dies ist die Konsole. Damit wird ein Window für die Tastatur-Ein-/Ausgabe geöff¬ 
net. Die Syntax lautet: 

CON: x/y/Brei te/Höhe/Titel 
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D.4.8 RAW: 

Das ist, um das AmigaDOS-Handbuch zu zitieren, »für den fortgeschrittenen 
Anwender gedacht. Experimentieren Sie nicht mit RAW:«. 


D.4.9 * 

Ist zwar keine Einheit, kann aber als Dateiname verwendet werden und bezeichnet 
das aktuelle CLI-Fenster. 

D.5 AmigaDOS-Befehle 

Um Ihnen beim Einsatz des CLI zu helfen, folgt nun eine kurze Beschreibung der 
am meisten verwendeten Befehle zusammen mit Beispielen. Es ist keine voll¬ 
ständige Beschreibung. Wenn Sie weitere Details benötigen, empfehlen wir, auf 
weiterführende Literatur zurückzugreifen. 

»[ 1« bezeichnen erforderliche Parameter, »< >« optionale. Die meisten Kommandos 
erlauben die Umleitung der Ausgabe mit dem »>«-Zeichen, so kann zum Beispiel 
ein Directory-Listing in einen File geschrieben werden mit 

dir >allfiles.txt 


ASSIGN <Name> <Directory> 

Dies erlaubt Ihnen, spezielle Namen - besonders für Directories - zu vergeben. 
Beim Start werden vom System die folgenden Zuweisungen gesetzt: 


Name 

Voreinstellung 

Anwendung/Zweck 

C: 

boot:c 

CLI sucht hier Kommandos 

L: 

boof.l 

System-Händlers 

S: 

boot:s 

Startup-sequence 

LIBS: 

boot:libs 

Libraries nicht im ROM 

DEVS: 

boot:devs 

Geräte-Treiber 

FONTS: 

boot:fonts 

Zeichensätze nicht im ROM 

SYS: 

boot: 

Boot-Diskette 


Genauso gut, wie Sie das ändern können, können Sie auch eigene Zuweisungen 
machen. Wenn Sie zum Beispiel einfacher auf das Graphics-Include-File auf der 
Diskette im externen Laufwerk zugreifen wollen, schreiben Sie 
assign graf: dfl:include/graphics ( Return 1 



126 Anhang D 


Dann können Sie unabhängig vom aktuellen Directory auf Files in dieser Art 
zugreifen: 

type graf:rastport.i 

Um alle Zuweisungen aufzulisten, geben Sie nur »assign« ein, und um eine 
Zuweisung aufzuheben, wiederholen Sie sie, ohne das Directory (den Pfad) 
anzugeben. 

CD <Directory> 

Dies ändert entweder das Directory, wenn dem CD ein Parameter folgt, oder zeigt 
das aktuelle Directory an (wenn nur CD eingegeben wird). 

COPY [Altname] <TO> [Neuname] <ALL> <QUIET> 

COPY kopiert Files einzeln oder in Gruppen oder auch ein ganzes Directory. Mit 

der ALL-Option werden Directories kopiert. Die QUIET-Option unterdrückt das 

Listing der Filenamen. Jedes existierende File wird ohne Rückfrage überschrieben. 

Am besten zeigt man das anhand von Beispielen: 

copy examples/demo.s to ramrdemo.s (ReturnI 

kopiert ein einzelnes File. 

copy examples to dflrgenexamples all IReturnI 

kopiert ein komplettes Directory in ein anderes (das bereits existieren muß), 
copy include to dfl:include all IReturnI 

kopiert das Include-Directory sowie alle Directories darin auf das externe Laufwerk 
und legt dabei die neuen Directories an, soweit nötig, 
copy #?.info ram: 

kopiert alle Files, die mit ».info« enden, auf die RAM-Disk. 

DATE <Datum> <Zeit> 

DATE zeigt oder setzt das Datum und/oder die Uhrzeit. Das Format für das Datum 
ist TT-MMM-JJ, das für die Zeit HH:MM. Es werden beide zusammen oder einzeln 
gesetzt. Folgt kein Parameter, wird der Ist-Stand angezeigt. Beispiel: 
date 25-jan-87 12:00 

DELETE [Name] <Name> <Name>.. <ALL> 

DELETE löscht Files einzeln oder in Gruppen oder auch ein ganzes Directory. 
Wenn Sie nur ein Directory angeben, wird es nur gelöscht, wenn es leer ist. Die 
ALL-Option löscht aber vorab den Inhalt, z.B. 
delete demo.s IReturn I 
delete examples all IReturn] 
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DIR <Name> 

Listet das aktuelle Directory, wenn »Name« fehlt, sonst das benannte Directory. 

DISKCOPY (Laufwerk) TO (Laufwerk) <NAME Name> 

Dadurch wird eine Diskette komplett auf eine andere kopiert. Die Zieldiskette muß 
nicht formatiert sein, alle darauf vorhandenen Files werden gelöscht. Wenn Sie für 
beide Laufwerke denselben Namen angeben, werden Sie jeweils zum Disketten¬ 
wechsel aufgefordert. Es wird empfohlen, auf der Quelldiskette den Schreibschutz 
zu aktivieren, bevor Sie das Programm starten. Sonst könnten versehentlich Daten 
verlorengehen. Per Voreinstellung bekommt die Zieldiskette den Namen des 
Originals, das kann aber mit der NAME-Option geändert werden, 
diskcopy dfO: to dfl: [Return] 
diskcopy dfO: to dfO: name "Backup" IReturnI 

ECHO <String> 

Das Kommando gibt »String« auf dem Schirm aus. Es ist hauptsächlich in der 
Startup-Sequence (siehe Abschnitt D.6) und in Execute-Batch-Files von Nutzen. 
Beispiel: 

echo "Devpac Amiga Workbench disk" I Return I 

ENDCLI 

Damit verlassen Sie das aktuelle CLI, aber Vorsicht!!! Sind Sie nämlich schon im 
letzten CLI (CLI 1) und haben Sie nicht die Workbench geladen (mit »loadwb«), 
kommen Sie nicht mehr zurück. Sie können dann nur noch neu booten. Der Befehl 
ist zum Verlassen von CLIs gedacht, die Sie vorher mit NEWCLI eingerichtet 
hatten. 

EXECUTE [Name] <Argumente> 

Für häufig verwendete Kommandofolgen im CLI kann man ein Textfile anlegen, in 
dem die Kommandos aufgeführt werden. Ruft man dieses Textfile mit EXECUTE 
auf, so werden alle Befehle nacheinander abgearbeitet. Parameter werden an Stelle 
von Platzhaltern eingesetzt. Dies funktioniert ähnlich wie bei den Makros von 
GenAm. Heißt das Textfile zum Beispiel »doit« und enthält diese Anweisungen 
.key file/a 
copy <file> to ram: 
copy ram:<file> to prt: 
delete ram:<file> 
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dann bewirkt 

execute doit demo.s [ ReturnI 

daß das File demo.s auf die RAM-Disk kopiert wird, von dort auf den Drucker (und 
somit gedruckt wird) und schließlich auf der RAM-Disk gelöscht wird. Das ».key« 
spezifiziert einen Parameter (hier file) und »/a« bedeutet, daß der Parameter immer 
(always) erforderlich ist. 

FAULT <Zahl> 

Dieses Kommando gibt die Bedeutung (als Text) einer Fehlemummer von 
AmigaDOS auf dem Schirm aus. 

FORMAT DRIVE [drivename] NAME [diskname] 

FORMAT initialisiert (formatiert) eine Diskette, wobei ihr bisheriger Inhalt zerstört 
wird, »drivename« kann DFO: oder DFl: sein, »diskname« ist der Name der 
Diskette. Beispiel: 

format drive dfl: name "My backups" [ Return I 

INFO 

INFO bringt folgende Informationen auf den Schirm: Status jedes Laufwerks und 
Jeder montierten Diskette einschließlich deren Namen und des freien Bereichs in 
Blöcken. Ein Block hat 512 Byte, womit die Hälfte der Blockzahl die Größe in 
Kbyte angibt. 

JOIN [fdel] <rile2 rile3 u.s.w.> AS [newfde] 

JOIN kopiert bis zu 15 Files zusammen in ein neues File, wie zum Beispiel: 
join partl part2 AS allparts [ Return I 

LIST <Name> 

LIST wirkt wie DIR, nur daß auch noch die File-Größe und das Entstehungsdatum 
angezeigt werden. 

LOADWB 

Dieses Kommando lädt die Workbench und bringt deren Screen hinter das CLI- 
Window. Die Standard-Workbench-Disketten haben diese Anweisung in der 
»Startup-sequence«, so daß die Workbench automatisch geladen wird. Auf der 
GenAm-Diskette fehlt das, womit Speicher gespart wird. 
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MAKEDIR [Directory] 

Damit wird ein neues Directory angelegt. Es darf kein File oder Directory gleichen 
Namens bereits existieren. 

NEWCLI <Window> 

Damit wird ein neues CLI angelegt, das als parallele Task läuft. Zusätzlich kann das 
Window wie bei CON: (siehe D.4.7) spezifiziert werden. 

RENAME [Altfile] <TO> [Neufile] 

Dieses Kommando ändert den Namen eines Files. Es kann auch benutzt werden, um 

ein File in ein anderes Directory zu bringen. Beispiele: 

rename demo.s to demo.bak IReturnI 

rename include/misc/start.i to examples/startup.s 

RUN [Kommando] 

RUN erlaubt, Kommandos oder Programme parallel (gleichzeitig) ablaufen zu 
lassen. Dazu wird ein neues CLI (ohne Fenster) geöffnet, dem das Kommando über¬ 
geben wird. Nach dessen Ende wird das CLI wieder entfernt. Wenn Sie eine Folge 
von Kommandos so laufen lassen wollen, müssen Sie ein Pluszeichen (-I-) an das 
Ende jeder Zeile setzen. Beispiele: 
run copy demo.s to prt: IReturnI 
druckt den File demo.s im Hintergrund, während 
run copy demo.s to prt:+ IReturnI 
echo "File ist gedruckt" [Return] 
das gleiche tut, dann aber noch die Meldung bringt. 

STACK <Größe> 

Dieses Kommando setzt die Stack-Größe für alle Tasks, die unter dem CLI laufen, 
oder zeigt nur die Ist-Größe an, wenn man »Größe« wegläßt. Voreingestellt sind 
4000 Byte, was für alle CLl-Kommandos und unsere Programme ausreicht, aller¬ 
dings mit einer Ausnahme. Beim DIR-Kommando reichen bei sehr tiefgeschach¬ 
telten Directories 4000 Byte nicht aus. Außerdem gibt es andere Programme (wie 
einige C-Compiler), die einen größeren Stack benötigen. Das sollte aber im Hand¬ 
buch dieser Programme dokumentiert sein. 
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TYPE [Name] <OPT N> <OPT H> 

Das Kommando wird normalerweise benutzt, um ein Textfile auf dem Schirm aus¬ 
zugeben, wobei das Display mit der rechten Maustaste angehalten werden kann. 
Wenn Sie ein Nicht-Textfile ausgeben, kann es Vorkommen, daß der Zeichensatz 
umgeschaltet wird und dann nur noch Unsinn erscheint. Um das zu korrigieren, 
drücken Sie 

[ Return 11 Ctrl l -[0] [ Return 1 

Die N-Option fügt Zeilennummem hinzu, mit der H-Option erreichen Sie den 
üblichen Hex-Dump mit gleichzeitiger ASCII-Darstellung (nicht druckbare Zeichen 
als Punkte). 

WHY 

WHY (warum) kann nach einer CLI-Fehlermeldung eingegeben werden und bringt 
dann noch weitere Erklärungen. 

D.6 Startup-Sequence 

Wenn Sie von einer Workbench-Diskette booten, wird das File »s/startup-sequence« 
geladen, dann werden alle darin aufgeführten Kommandos ausgeführt. Eines dieser 
Kommandos heißt »loadwb« (lade Workbench). Genau diese Anweisung fehlt auf 
der GenAm-Diskette, außerdem auch der sonst vorhandene ENDCLI-Befehl. Damit 
bleiben Sie im CLL Wenn Sie das File editieren wollen, können Sie das mit GenAm 
tun. Geben Sie ein 

genam srstartup-sequence I Return I 

(s: bewirkt, daß das File unabhängig vom aktuellen Directory gefunden wird.) Sie 
können nun das File ändern. Die neue Sequenz wird beim nächsten Booten aus¬ 
geführt. 
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Konvertierung von 
anderen Assemblern 


Einführung 

Die meisten Assembler für den Amiga folgen mehr oder weniger dem Motorola- 
Standard. Die Befehle an sich sind zwar am Standard ausgerichtet, die Syntaxregeln 
für Labels, Kommentare und Direktiven können dagegen variieren. In diesem 
Anhang werden die Veränderungen behandelt, die sich ergeben, wenn Programme 
von einem anderen Assembler konvertiert werden, gleichgültig, ob es alte Quell¬ 
dateien oder in einer Zeitschrift abgedruckte Listings sind. 

E.1 Amiga-Makro-Assembler und MCC-Assembler 

Fast alle Quellcodes, die unter dem von Commodore unterstützten AmigaDOS- 
Makro-Assembler und dem Metacomco-Assembler (MCC) geschrieben wurden, 
können mit ein paar kleinen Änderungen unter GenAm assembliert werden. Die 
Unterschiede sind: 

1. GenAm erzeugt Fehlermeldungen, wenn Konstanten importiert werden, die 
XREF verwenden, und auf die dann als Konstanten (als Gegensatz zu relativen 
Adressen) zugegriffen wird. Viele Quelltexte benutzen XREFs für _LVO-Labels. 
Um den Warnungen entgegenzuwirken, tun Sie am besten folgendes: 

• Ändern Sie XREF in XREF.L. 

• Verwenden Sie OPT W-, um alle Warnungen zu unterdrücken. 

• Verwenden Sie OPT T-, um eine Typenüberprüfung zu vermeiden. 

• Includen Sie die entsprechende _lib.i-Datei, und entfernen Sie XREF. 

2. Der Befehl RORG wird nicht unterstützt. 

Die mit dem AmigaDOS-Makro-Assembler mitgelieferten Include-Dateien werden 
von GenAm ohne Änderungen assembliert, jedoch sollte den von uns gelieferten 
Include-Files der Vorzug gegeben werden, da sie anstatt Makros Direktiven ver- 
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wenden und schneller assembliert werden. Außerdem brauchen Sie weniger 
Speicherplatz. 

E.1.1 K-Seka 

ln GenAm ist nach Labels kein Komma erforderlich, jedoch benötigen Direktiven 
und Befehle, die im Label-Feld beginnen, einen vorangesetzten Tab. Eine Anzahl 
von Seka-Direktiven haben als Grundeinstellung anstatt Wortgrößen Bytes. Gleich¬ 
wertige Direktiven sind: 

D=DC, BLK=DS, 1F=1FNE, ELSE=ELSE1F, END1F=ENDC. 

ln der Makro-Syntax müssen »?« in »\s« geändert werden; Jedoch muß »?0« in 
»N<a)« geändert werden. 


E.2 Neue Commodore-Include-Files 

Sollten Sie neue Include-Dateien von Commodore besitzen, müßten Sie ohne Ände¬ 
rungen unter GenAm assemblieren können. Wollen Sie sie jedoch in das Format 
konvertieren, das von uns unterstützt wird, um Assemblierzeit und Speicherplatz zu 
sparen, benutzen Sie die von uns gelieferten Tools ConvertFD und Convertl. 

E.2.1 Convertl 

Convertl wird auf Disk 2 ausgeliefert und konvertiert Commodore-lnclude-Dateien 
in das komprimierte Format, das wir verwenden. Die Kommandozeile sieht so aus: 

Convertl [Quelle] [Ziel] <-d> 

Die Extension ».i« der Quell- und Zieldatei muß weggelassen werden. Das Flag -d 
zeigt an, daß das ganze Directory konvertiert wird. Zum Beispiel konvertiert 

Convertl alt/dos neu/dos 

die Datei alt/dos.i in neu/dos.i. 

Convertl alt neu -d 

konvertiert die Standard-lnclude-Dateien im Verzeichnis »alt« in die jeweils korre¬ 
spondierende Datei im Verzeichnis »neu«. 
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E.2.2 ConvertFD 

ConvertFD wird auf Disk 2 mitgeliefert und konvertiert Commodore-FD-Dateien in 
Library-Include-Dateien mit der Extension »Jib.i«, die die _LVO-Offsets enthalten, 
die in Ihr Programm includet werden sollen. 

Die Kommandozeile hat das Format 

ConvertFD [Quelle [Ziel] <-d> 

Die Extensionen der Quell- und Zieldateien müssen weggelassen werden, -d zeigt 
an, daß ein ganzes Verzeichnis konvertiert wird. Zum Beispiel konvertiert 

Convertl fdfiles/dos neu/dos 

die Datei »fdfiles/dosjib.fd« in »neu/dos_lib.i«. 

Convertl fdfilesrinclude/1ibraries -d 

konvertiert alle fd-Dateien im Verzeichnis »fdfiles« in das entsprechende Include- 
File im Verzeichnis »linclude/libraries«. 
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Verbesserungen 
in der Version 2.0 


Dieser Abschnitt ist als Schnellübersicht für diejenigen Benutzer gedacht, die das 
Update von der Version 1.0 auf Version 2.0 erworben haben. 


F.1 Der Editor 

Der Editor läuft nun nach entsprechender Voreinstellung unter 60- und SOspaltigem 
Textmodus. Die Speichergröße kann nun im Editor eingestellt werden, wodurch das 
Installationsprogramm der Version l.O überflüssig wird. 

Block löschen kann nun mit [ Shift l - ff^ und I Shift I - UTI erreicht werden. Der Block 
wird im Blockspeicher behalten und kann so nach Bedarf wieder eingefügt werden. 
Blockmarkierungen werden auf dem Bildschirm angezeigt. 

F.1.1 Der Assembler 

Die ersten 127 Zeichen von Symbolen sind signifikant, lokale Labels werden unter¬ 
stützt; das Format entspricht dem des Amiga-Makro-Assemblers. Mit der INCBIN- 
Direktive wird ein Binärtüe in eine Ausgabedatei kopiert, was für Bildschirmdaten 
sehr nützlich sein kann. 

Include-Files werden nur noch einmal gelesen, wodurch Speicherplatz und Zeit 
gespart wird. Die maximale Assembliergeschwindigkeit beträgt 75.000 Zeilen pro 
Minute, der Durchschnittswert beträgt 35.000 Zeilen pro Minute. Die Geschwindig¬ 
keit, mit der Symboltabellen durchsucht und aufgeteilt werden, wurde ebenfalls 
erhöht. 

Makro-Aufrufe und Includes können so tief verschachtelt werden, wie es der 
Speicherplatz erlaubt, IFs bis zu 64 Ebenen tief. Der Output von Dateinamen wird 
besser kontrolliert; verschiedene AmigaDOS-Sektionen (oder Module) werden nun 
voll unterstützt. 
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Makros können bis zu 36 Parameter von mehrlinigen Aufrufen und numerischer 
Substitution bei sich haben. Der Makro-Puffer wird dynamisch verwaltet, wobei 
nicht länger der freie Speicher des Editors dafür verwendet wird. REPEAT-Schlei- 
fen werden nun ermöglicht; eine nützliche Erweiterung stellen Vergleichsoperatoren 
dar. Mit der REG-Direktive können symbolische Registerlisten verwendet werden. 
Die OPT-Direktive unterstützt eine stattliche Anzahl von Extensionen. Oktale 
Zahlen sind inzwischen zugelassen. Register können mit RO bis R15 aufgerufen 
werden. 

Der Gebrauch von \W und \L nach Register-Equates, die als Index-Register ver¬ 
wendet werden, ist nicht länger erforderlich, da z.B. nach »buf« als Register-Equate 
»move.b d0,0(a6,buf.l)« nicht erlaubt ist. In MOVEMs sind Register-Equates 
erlaubt. 


Kompatibilität 

Die meisten Quelldateien sollten ohne größere Änderungen assembliert werden. Die 
Unterschiede sind: 

• Symbole sind nun case-sensitiv, die ersten 127 Zeichen sind signifikant. 

• OPT N für schmale Listings wurde durch die FORMAT-Direktive ersetzt, die 
eine größere Flexibilität erlaubt. Die Listing-Kontrolle wurde generell ver¬ 
bessert. 

• In Version 1.0 wurde BRA.W nicht akzeptiert, dagegen aber BRA.L, der genau¬ 
genommen ein 68029er-Befehl ist. BRA.L generiert nun eine Warnmeldung, 
BRA.W (und BRA.B) werden nun angenommen. 

• Bezüglich des Parsing von Ausdrücken wurden mehrere kleinere Änderungen 
unternommen, um die Flexibilität zu erhöhen. Die Verwendung von (Aus- 
druck)\W (das eine Kurzwort-Adresse angibt) innerhalb eines Makros wird igno¬ 
riert, da sich\W und\L auf Makro-Parameter beziehen und durch Nullen ersetzt 
werden. Benutzen Sie statt dessen (Ausdruck).W, das sich im Motorola-Standard 
befindet. 

• Die Priorität des Gleichheits-Operators (=) wurde geändert. 

Der Assembler zeigt syntaktische Fehler bereits in Pass 1 an; wenn Fehler gefunden 
wurden, wird Pass 2 nicht gestartet. Da AmigaDOS-Output-Routinen verwendet 
werden, kann mit einem Tastendruck eine Pause gemacht, mit I Return I abgeschickt 
und mit 1 Ctrl l -fc] abgebrochen werden. 
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Es gibt eine Anzahl neuer Direktiven, die sich theoretisch mit Makro-Namen in 
GenAml-Quell-Dateien überschneiden könnten: COMMENT, DCB, ELSEIF, 
ENDR, FORMAT, IIF, INCBIN, OFFSET, OUTPUT, REG, REPT, RSSET, 
SUBTTL. 

Es gibt drei reservierte Symbole, die mit einem Unterstrich beginnen: _LK, _RS und 
G2. 

F.1.2 Der Debugger 

MonAm unterstützt eine Anzahl neuer Features und besitzt daher ein verändertes 
User-Interface. Die Flaupt-Features sind: Anzeige mit mehreren Fenstern; Aus¬ 
wertung von Indirektionen; Sie können ein mit niedriger Auflösung erstelltes Pro¬ 
gramm in hoher Auflösung debuggen (und umgekehrt); Quelldateien können im 
Debugger betrachtet werden; Disassemblierung in GenAm-Format mit auto¬ 
matischem Label-Generator zum Drucker oder auf Diskette; History-Puffer; 
Bedingte Breakpoints; liest auch Debugcode mit mehreren Hunks (wie von Lattice 
C); zeigt _LVO-Offsets für Library-Aufrufe an. 

F.1.3 Integration 

Die wohl größte Verbesserung ist die Integration aller Teile im gesamten Paket. Der 
Assembler und der Debugger sind vom Editor aus auf Tastendruck verfügbar. Der 
Assembler assembliert direkt in den Speicher; der Code kann dann im Editor ohne 
Diskettenzugriffe ablaufen. Falls erforderlich, kann die Debug-Information in 
Programme integriert werden, die in den Speicher assembliert wurden. Sie können 
dann vom Editor aus mittels Tastendruck assembliert werden. 

Der Editor merkt sich Fehler und Warnungen, so daß sie mit [Ä]-[T] durchgegangen 
werden können. Wenn die Zeilennummer geändert wird, gehen die Fehler nicht 
mehr verloren (obwohl keine Neuberechnung angestellt wird). Nach einem 
Assemblerlauf, in dem ein Fehler auftrat, wird der Cursor in der ersten fehlerhaften 
Zeile plaziert. 
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A 

Adresse 57 
Adreßfehler 20, 102 
Adreßregister 51 
AmigaDOS-Fehlemummer 30 
AmigaDOS-Header 73 
Anfangsadresse 87 
Assembler 11 
Assembler-Module 16 
Assemblieren 35 
Assemblieren, bedingtes 63 
Assemblierfehler 18 
Asterix 47 

Auflösung, niedrige 87 
Ausdruck, numerischer 84 

ß 

Backups 30 
Befehl, illegaler 102 
Bildschirm-Editor 11,24 
Bildschirmumschaltung 89 
Binär-File 39 
Bit-Test-Befehl 51 
Blockpuffer 33 
Breakpoints 83 
Breakpoints, bedingte 90 
-, einfache 90 
-, permanente 90 
BSS-Sektion 71 
Busfehler 102 


C 

Chip Memory 71 
Code, ausführbarer 70 
-, linkbarer 70 

-, positionsunabhängiger 55, 73 
-, sofort ausführbarer 16 
CODE-Sektion 71 
Condition-Code 51 

D 

DATA-Sektion 71 
Deallokation 97 
Debug, erweiterter 56 
Debug-Code 63 
Debuggen 36 

Debugger, symbolischer 77 
Debugging-Information 54 
Deinitialisierung 22 
Disassembler 77 
Disk-File 33 
Druckertreiber 14 
Druckertyp 33 

E 

Editor-Puffer 30 
Entwicklungstools 12 
Exception 77 
Exec-Library 21 
Expansion 21 
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Exporte 72 
Extension 43 

F 

Fast Memory 71 

G 

Gadget 37 
Grafik-Library 87 

H 

Hilfsbildschirm 34 
History-Buffer 91 
Hunk 84 

I 

Importe 72 
Include-Datei 11 
Indirektion 85 
Initialisierung 35 
Intuition 24 
Intuition-Library 87 

J 

Justierung 57 

K 

Kickstart-Diskette 12 
Kommentar-Feld 45 

L 

Label, lokales 49 
Label-Feld 44 
Langwortgröße 85 
Langwortzeiger 102 
Linker 1 
- Modus 54 
Listing 54 

Low-Lewel-Debugger 77 

M 

Makro-Expansion 54 
Makro-Puffer 65 
Makroentwicklung 65 
Mnemonik-Feld 45 


Module 16,72 
Modus, case-sensitiver 65 
Move-Anweisung 21 

N 

Narrow 54 

O 

Objektmodule, linkbares 43 
Offsets, relative 96 
Opcode 94 
Optimierung 55 
Output-Handle 22 

P 

Prädekrement 86 
Privilegverletzung 102 
Programmzähler 21 
Pseudo-Mnemonik 52 

Q 

Quellcode-Datei 18 

R 

RAM-Bereich, oberer 96 
Register-Equates 49 
Registerkorrektur 102 
Registemame 45 
Relozierinformation 43, 73 
Repeat-loop-Konstruktion 58 
Requester 25, 30 
ROM-Breakpoints 91 

S 

Sektion 71 

Single-Steppen 21,82 
Source-Operand 51 
Speicherlimit 24 
Stack-Zeiger 45 
Stand-alone-Assembler 41 
Stop-Breakpoint 90 
Stringabgrenzung 47 
Supervisor-Modus 85, 101 
Supervisor-Stack-Pointer 85 
Symbol, reserviertes 65 
Symbol-Optionen 96 
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Symboltabelle 55 
Syntaxcheck 40 

T 

Tabulator-Taste 28 
Text-Gadget 26 
Trace-Bits 77 
Trace-Exception 92 
Turn-around-Zeiten 42 
Typen-Überprüfung 55 

U 

Unterstrich 56 
Useimodus 85 


V 

Voll-Screen-Editor 23 
Voreinstellung 35 

W 

Warnung 56 
Wortgrenze 50 

Z 

Zähler-Breakpoints 90 
Zeilen-Editor 24 
Ziel-Operand 51 
Zoom-Kommando 83 
Zwei-Paß-Assembler 42 
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Atlantis 

AmigaCall 

Treten Sie ein in die 
faszinierende Welt der 
Datenfernübertragung. 
Kommunizieren Sie über 
Mailboxen mit erfahrenen 
Computer-Anwendern, 
die Ihnen bei Ihren Pro¬ 
blemen weiterhelfen kön¬ 
nen, oder Sie erhalten auf 
diesem Wege leistungs¬ 
fähige Public-Domain- 
Software. AmigaCall 
nimmt Ihnen die meiste 
Arbeit ab. Schließen &e 
Ihr Modem oder Ihren 
Akustikkoppler an, starten 
Sie AmigaCall - und auf 
geht’s. 

1988, 133 Seiten, inkl. 
3V2"-Programmdiskette 
Bestell-Nr. 90716 
ISBN 3-89090-716-4 

DM QQ.* 

(sFr 9 i!-*/öS 842,-*) 


Atlantis 
Trickstudio A 

Ob Sie Computerfilm- 
Pionier sind oder Trick¬ 
profi, ob Sie von Walt Dis¬ 
ney inspiriert sind oder 
einfach nur einen guten 
Lehrfilm für technische 
Abläufe benötigen: Mit 
Trickstudio A können Sie 
Ihre eigenen Trickfilme 
erstellen und diese mit 
Sound und Geräuschen 
untermalen. 

Wie wäre es also mit 
einem Stummfilm-Slap¬ 
stick, einem Krimi oder 
einem Werbefilm für Ihr 
Schaufenster? Dazu Ihre 
Lieblingsmusik oder 
digitalisierte Stimmen? 
Entwerfen Sie die Einzel¬ 
bilder, z. B. mit Deluxe 
Paint, erstellen Sie eine 
Sounddatei und dann; 
Klappe - Film; die erste. 
1988, 86 Seiten, inkl. 

3 V 2 "-Programmdiskette 
Bestell-Nr. 90715 
ISBN 3-89090-715-6 
DM 99,-* 

(sFr 91,-‘/öS 842,-*) 


R.Arbinger/l. Krüger 

Scriptum 

Scriptum - das schnelle, 
leistungsfähige Textverarbei- 
tungssystem für den Amiga. 
Ausführliche Bedienungsan¬ 
leitung im Buch. Für alle, 
die auf dem Amiga Texte 
verarbeiten wollen. 


1989, ca. 200 Seiten, inkl. 
3 V 2 "-Programmdiskette 
Bestell-Nr. 90650 
ISBN 3-89090-650-8 

DM 79,-* 

(sFr 72,70*/öS 672,-*) 

* Unverbindliche 
Preisempfehlung 


Markt&Technik 


Zeitschriften • Bücher 


Software • Schului 


Markt&Technik Verlag AG, Buchverlag, Hans-Pinsel-Straße 2, 8013 Haar bei München, Telefon (089) 4613-0 


















Devpac Assembler 

* für die Amiga 500,1000 und 2000 


Mit Devpac 2.0 für den Amiga 
liegt Ihnen ein Entwicklungs¬ 
paket vor, mit dem das Pro¬ 
grammieren Spaß macht: ein 
integrierter 68000er Makro- 
Assembler, ein vollständiger 
Bildschirmeditor und ein 
mächtiger Disassembler/De¬ 
bugger stellen ein maßge¬ 
schneidertes Paket dar, mit 
dem Sie jede Programmier¬ 
hürde meistern. 


Der Assembler/Editor: 


GenAm ist ein schneller 
Makro-Assembler, der durch¬ 
schnittlich 35000 Zeilen in 
einer Minute assembliert. 
Danach steht ein bereits aus¬ 
führbares Programm bereit. 
Liegt ein Programmfehler 
vor, gelangen Sie unmittelbar 
in den Editor und können so 
komfortabel die fehlerhaften 
Eingaben korrigieren. Der 
Editor arbeitet mit Intuition - 
Sie müssen also nicht auf 



Markt&Technik 


AMIGA-Software 


Fenstertechnik, Mausbedie¬ 
nung und Menüs verzichten. 
Die Syntax des Assemblers 
ist Motorola-Standard. Es 
können sowohl linkbare als 
auch sofort ausführbare Da¬ 
teien generiert werden. Beim 
Makro-Aufruf sind bis zu 36 
Parameter erlaubt; Makro- 
Aufrufe und Includes können 
so tief verschachtelt werden, 
wie es der verfügbare Spei¬ 
cherplatz gestattet. Symbole 
besitzen eine Signifikanz von 
127 Zeichen, lokale Labels 
werden unterstützt. 


Der Disassembler/ 
Debugger:_ 


MonAm ist ein symbolischer 
Disassembler/Debugger, mit 
dem erstellte Programme in¬ 
klusive aller Labels im Spei¬ 
cher untersucht werden. Das 
zeit- und nervenraubende 
Analysieren von Hexzahlen 
entfällt somit. MonAm bietet 



auch die Möglichkeit, einzel¬ 
ne Befehle schrittweise nach¬ 
einander auszuführen und 
Breakpoints zu setzen. Durch 
Programmfehler entstehen¬ 
de Exceptions werden vom 
Debugger abgefangen, so 
daß es selten zu den berüch¬ 
tigten »Guru«-Meldungen 
kommt. 


Lieferumfang: 


• 3V2 "-Diskette 

• deutschsprachiges Hand¬ 
buch 


Hardware-Anforderungen: 


• Amiga 500, 1000 oder 
2000 mit mindestens 512 
Kbyte RAM 

• Monochrom-Monitor 

• mindestens ein Disket¬ 
tenlaufwerk 


Software-Anforderungen: 


• Kickstart Version 1.1 oder 
höher 


Unverbindliche 

Preisempfehlung 

DM 149,- 

sFr 135,- 
ÖS 1490,- 


Hans-Pinsel-Straße 2 
D-8013 Haar bei München 












































